jl-sprt-core 1.4.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,13 +1,35 @@
1
- export interface TeamAttributes {
2
- attack: number;
3
- defense: number;
4
- }
5
- export declare abstract class A_TeamRoster {
1
+ import type { RosterContext } from './Match/RosterContext';
2
+ /**
3
+ * Roster de un team para UN partido.
4
+ *
5
+ * Es un objeto vivo: mantiene el estado de campo del team (hoy sólo sus atributos
6
+ * efectivos; a futuro alineación, estrategia, jugadores en cancha) y lo reevalúa
7
+ * durante el partido. Los datos persistentes del team (plantilla, instalaciones,
8
+ * entrenadores, hinchas...) NO viven acá: cada deporte los recibe del team al
9
+ * construir el roster.
10
+ *
11
+ * Core define CUÁNDO se recalcula y QUÉ información entra (`RosterContext`);
12
+ * cada deporte define QUÉ atributos existen (`TAtts`) y CÓMO se calculan
13
+ * (`resolveAttributes`).
14
+ *
15
+ * `A_MatchPlay` llama a `update(ctx)` al iniciar el partido y antes de cada
16
+ * intervalo. `resolveAttributes` debe ser barato y determinista (si necesita azar,
17
+ * usar la misma fuente aleatoria de la simulación).
18
+ */
19
+ export declare abstract class A_TeamRoster<TAtts = unknown> {
6
20
  private _id;
7
- private _attributes;
8
- constructor(id: string, atts: TeamAttributes);
21
+ private _atts;
22
+ private _resolved;
23
+ constructor(id: string);
9
24
  get id(): string;
10
- get atts(): TeamAttributes;
25
+ /** ¿Ya se evaluó al menos una vez con un contexto de partido? */
26
+ get isResolved(): boolean;
27
+ /** Atributos efectivos vigentes. Lanza si el roster todavía no fue evaluado. */
28
+ get atts(): TAtts;
29
+ /** Reevalúa los atributos efectivos con el contexto actual del partido. */
30
+ update(ctx: RosterContext<any>): void;
31
+ /** Cálculo de atributos efectivos. Conocimiento propio de cada deporte. */
32
+ protected abstract resolveAttributes(ctx: RosterContext<any>): TAtts;
11
33
  }
12
34
  export declare class Player {
13
35
  }
@@ -1,13 +1,45 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.Player = exports.A_TeamRoster = void 0;
4
+ /**
5
+ * Roster de un team para UN partido.
6
+ *
7
+ * Es un objeto vivo: mantiene el estado de campo del team (hoy sólo sus atributos
8
+ * efectivos; a futuro alineación, estrategia, jugadores en cancha) y lo reevalúa
9
+ * durante el partido. Los datos persistentes del team (plantilla, instalaciones,
10
+ * entrenadores, hinchas...) NO viven acá: cada deporte los recibe del team al
11
+ * construir el roster.
12
+ *
13
+ * Core define CUÁNDO se recalcula y QUÉ información entra (`RosterContext`);
14
+ * cada deporte define QUÉ atributos existen (`TAtts`) y CÓMO se calculan
15
+ * (`resolveAttributes`).
16
+ *
17
+ * `A_MatchPlay` llama a `update(ctx)` al iniciar el partido y antes de cada
18
+ * intervalo. `resolveAttributes` debe ser barato y determinista (si necesita azar,
19
+ * usar la misma fuente aleatoria de la simulación).
20
+ */
4
21
  class A_TeamRoster {
5
- constructor(id, atts) {
22
+ // private _starters: Player[] = [];
23
+ // private _subs: Player[] = [];
24
+ constructor(id) {
25
+ this._resolved = false;
6
26
  this._id = id;
7
- this._attributes = { ...atts };
8
27
  }
9
28
  get id() { return this._id; }
10
- get atts() { return this._attributes; }
29
+ /** ¿Ya se evaluó al menos una vez con un contexto de partido? */
30
+ get isResolved() { return this._resolved; }
31
+ /** Atributos efectivos vigentes. Lanza si el roster todavía no fue evaluado. */
32
+ get atts() {
33
+ if (!this._resolved) {
34
+ throw new Error(`Roster ${this._id}: attributes not resolved yet (update() was not called)`);
35
+ }
36
+ return this._atts;
37
+ }
38
+ /** Reevalúa los atributos efectivos con el contexto actual del partido. */
39
+ update(ctx) {
40
+ this._atts = this.resolveAttributes(ctx);
41
+ this._resolved = true;
42
+ }
11
43
  }
12
44
  exports.A_TeamRoster = A_TeamRoster;
13
45
  class Player {
@@ -1 +1 @@
1
- {"version":3,"file":"A_TeamRoster.js","sourceRoot":"","sources":["../src/A_TeamRoster.ts"],"names":[],"mappings":";;;AAKA,MAAsB,YAAY;IAMjC,YAAY,EAAU,EAAE,IAAoB;QAC3C,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,EAAE,KAAa,OAAO,IAAI,CAAC,GAAG,CAAA,CAAC,CAAC;IACpC,IAAI,IAAI,KAAqB,OAAO,IAAI,CAAC,WAAW,CAAA,CAAC,CAAC;CACtD;AAbD,oCAaC;AAED,MAAa,MAAM;CAElB;AAFD,wBAEC"}
1
+ {"version":3,"file":"A_TeamRoster.js","sourceRoot":"","sources":["../src/A_TeamRoster.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAsB,YAAY;IAIjC,oCAAoC;IACpC,gCAAgC;IAEhC,YAAY,EAAU;QAJd,cAAS,GAAG,KAAK,CAAC;QAKzB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,EAAE,KAAa,OAAO,IAAI,CAAC,GAAG,CAAA,CAAC,CAAC;IAEpC,iEAAiE;IACjE,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,SAAS,CAAA,CAAC,CAAC;IAEnD,gFAAgF;IAChF,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,GAAG,yDAAyD,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,IAAI,CAAC,KAAc,CAAC;IAC5B,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,GAAuB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;CAID;AAhCD,oCAgCC;AAED,MAAa,MAAM;CAElB;AAFD,wBAEC"}
@@ -32,6 +32,7 @@ export declare abstract class A_Match<MS extends TMatchScore, TR extends A_TeamR
32
32
  protected _awayTeam: A_Team<TR>;
33
33
  protected _date: JDateTime;
34
34
  protected _playing: A_MatchPlay<MS, TR>;
35
+ protected _isNeutral: boolean;
35
36
  constructor(info: IMatchCreationInfo<MS, TR>, getPlaying: (contextProvider?: MatchContextProvider<MS>) => A_MatchPlay<MS, TR>);
36
37
  get id(): string;
37
38
  get homeTeam(): A_Team<TR>;
@@ -39,6 +40,7 @@ export declare abstract class A_Match<MS extends TMatchScore, TR extends A_TeamR
39
40
  get date(): JDateTime;
40
41
  get state(): TypeMatchState;
41
42
  get isFinished(): boolean;
43
+ get isNeutral(): boolean;
42
44
  get result(): A_Result<MS> | undefined;
43
45
  /**
44
46
  * Contexto de serie del partido (si pertenece a una serie), o `undefined` si es
@@ -11,6 +11,7 @@ class A_Match {
11
11
  constructor(info, getPlaying) {
12
12
  this._state = 'created';
13
13
  this._id = info.id;
14
+ this._isNeutral = info.isNeutral;
14
15
  this._homeTeam = info.homeTeam;
15
16
  this._awayTeam = info.awayTeam;
16
17
  this._date = jl_calendar_1.JDateTime.createFromHalfWeekOfYearAndYear(info.hw, info.season, 'middle');
@@ -24,6 +25,7 @@ class A_Match {
24
25
  get date() { return this._date; }
25
26
  get state() { return this._state; }
26
27
  get isFinished() { return this._state === 'finished'; }
28
+ get isNeutral() { return this._isNeutral; }
27
29
  get result() {
28
30
  return this._playing.result;
29
31
  }
@@ -50,7 +52,7 @@ class A_Match {
50
52
  if (!(this._state === 'scheduled' || this._state === 'reschuduled'))
51
53
  throw new Error('Match is none scheduled');
52
54
  this._state = 'playing';
53
- this._playing.start(this._homeTeam.getTeamMatch(), this._awayTeam.getTeamMatch());
55
+ this._playing.start(this._homeTeam.getTeamMatch(), this._awayTeam.getTeamMatch(), { isNeutral: this._isNeutral, date: this._date });
54
56
  }
55
57
  advance() {
56
58
  if (this._state !== 'playing')
@@ -1 +1 @@
1
- {"version":3,"file":"A_Match.js","sourceRoot":"","sources":["../../src/Match/A_Match.ts"],"names":[],"mappings":";;;AAKA,6CAA4D;AA4B5D;;;;GAIG;AACH,MAAsB,OAAO;IAS5B,YAAY,IAAgC,EAAE,UAA+E;QAPnH,WAAM,GAAmB,SAAS,CAAC;QAQ5C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAE,IAAI,CAAE,QAAQ,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,uBAAS,CAAC,+BAA+B,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvF,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEjD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,EAAE,KAAa,OAAO,IAAI,CAAC,GAAG,CAAA,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAiB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAiB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,KAAgB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;IAEhE,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,IAAc,YAAY;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC9B,CAAC;IAcD,QAAQ,CAAC,EAAa;QACrB,IAAI,CAAC,MAAM;YACV,IAAI,CAAC,MAAM,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW;gBACvD,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,WAAW,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM;QACL,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC1B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAC7B,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAC5B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEzC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAExB,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACD;AApFD,0BAoFC"}
1
+ {"version":3,"file":"A_Match.js","sourceRoot":"","sources":["../../src/Match/A_Match.ts"],"names":[],"mappings":";;;AAKA,6CAA4D;AA4B5D;;;;GAIG;AACH,MAAsB,OAAO;IAU5B,YAAY,IAAgC,EAAE,UAA+E;QARnH,WAAM,GAAmB,SAAS,CAAC;QAS5C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,uBAAS,CAAC,+BAA+B,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvF,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEjD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,EAAE,KAAa,OAAO,IAAI,CAAC,GAAG,CAAA,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAiB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAiB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,KAAgB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;IAChE,IAAI,SAAS,KAAc,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpD,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,IAAc,YAAY;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC9B,CAAC;IAcD,QAAQ,CAAC,EAAa;QACrB,IAAI,CAAC,MAAM;YACV,IAAI,CAAC,MAAM,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW;gBACvD,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,WAAW,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM;QACL,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC1B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAC7B,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAC7B,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAChD,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAC5B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEzC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAExB,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACD;AAxFD,0BAwFC"}
@@ -2,6 +2,7 @@ import { TMatchScore } from './scores';
2
2
  import { A_Result } from './A_Result';
3
3
  import { A_TeamRoster } from '../A_TeamRoster';
4
4
  import type { MatchContext, MatchContextProvider } from './A_Serie';
5
+ import type { MatchConditions } from './RosterContext';
5
6
  /**
6
7
  * Fase del partido dentro del ciclo de simulación.
7
8
  * - 'regular' : tiempo reglamentario.
@@ -36,16 +37,19 @@ export type MatchPlayPhase = 'regular' | 'tiebreak' | 'finished';
36
37
  /**
37
38
  * FLUJO DE SIMULACIÓN DEL PARTIDO
38
39
  *
39
- * 1. INICIO — start(one, two)
40
- * - Asigna los dos equipos.
40
+ * 1. INICIO — start(one, two, conditions)
41
+ * - Asigna los dos equipos (`one` es el local) y las condiciones del partido.
41
42
  * - Inicializa el tiempo en 0.
42
43
  * - Establece la fase 'regular'.
43
44
  * - Ejecuta startPlay(), que inicializa el estado específico del deporte
44
45
  * y crea el resultado del partido.
46
+ * - Evalúa por primera vez los rosters (updateRosters()).
45
47
  *
46
48
  * 2. AVANCE — advance()
47
49
  * - Verifica que el partido haya sido iniciado.
48
50
  * - Si la fase es 'finished', no hace nada.
51
+ * - Reevalúa los rosters con el contexto actual (updateRosters()): cada roster
52
+ * recalcula sus atributos efectivos según tiempo, marcador, condiciones, etc.
49
53
  * - Si la fase es 'regular', ejecuta advanceRegular().
50
54
  * - Si la fase es 'tiebreak', ejecuta advanceTieBreak().
51
55
  *
@@ -97,6 +101,7 @@ export declare abstract class A_MatchPlay<MS extends TMatchScore, TR extends A_T
97
101
  protected _teamOne: TR | undefined;
98
102
  protected _teamTwo: TR | undefined;
99
103
  protected _contextProvider?: MatchContextProvider<MS>;
104
+ protected _conditions: MatchConditions | undefined;
100
105
  protected _phase: MatchPlayPhase;
101
106
  constructor(contextProvider?: MatchContextProvider<MS>);
102
107
  get time(): number;
@@ -105,13 +110,23 @@ export declare abstract class A_MatchPlay<MS extends TMatchScore, TR extends A_T
105
110
  get context(): MatchContext<MS> | undefined;
106
111
  /** El partido terminó cuando alcanzó la fase 'finished'. */
107
112
  get isFinished(): boolean;
108
- /** Inicia el partido. Los deportes NO sobreescriben esto; usan `startPlay`. */
109
- start(one: TR, two: TR): void;
113
+ /**
114
+ * Inicia el partido. Los deportes NO sobreescriben esto; usan `startPlay`.
115
+ * `one` es el local (en partidos neutrales es sólo nominal, ver `conditions`).
116
+ */
117
+ start(one: TR, two: TR, conditions: MatchConditions): void;
110
118
  /**
111
119
  * Avanza un intervalo de simulación. Coordina las fases; los deportes definen
112
120
  * qué ocurre dentro de cada fase vía los hooks.
113
121
  */
114
122
  advance(): void;
123
+ /**
124
+ * Reevalúa los atributos de ambos rosters con el contexto actual.
125
+ *
126
+ * Los dos contextos se construyen ANTES de actualizar cualquiera, a partir de la
127
+ * misma foto del partido, para que el resultado no dependa del orden.
128
+ */
129
+ private updateRosters;
115
130
  private advanceRegular;
116
131
  private closeRegularOrEnterTieBreak;
117
132
  private advanceTieBreak;
@@ -28,16 +28,19 @@ exports.A_MatchPlay = void 0;
28
28
  /**
29
29
  * FLUJO DE SIMULACIÓN DEL PARTIDO
30
30
  *
31
- * 1. INICIO — start(one, two)
32
- * - Asigna los dos equipos.
31
+ * 1. INICIO — start(one, two, conditions)
32
+ * - Asigna los dos equipos (`one` es el local) y las condiciones del partido.
33
33
  * - Inicializa el tiempo en 0.
34
34
  * - Establece la fase 'regular'.
35
35
  * - Ejecuta startPlay(), que inicializa el estado específico del deporte
36
36
  * y crea el resultado del partido.
37
+ * - Evalúa por primera vez los rosters (updateRosters()).
37
38
  *
38
39
  * 2. AVANCE — advance()
39
40
  * - Verifica que el partido haya sido iniciado.
40
41
  * - Si la fase es 'finished', no hace nada.
42
+ * - Reevalúa los rosters con el contexto actual (updateRosters()): cada roster
43
+ * recalcula sus atributos efectivos según tiempo, marcador, condiciones, etc.
41
44
  * - Si la fase es 'regular', ejecuta advanceRegular().
42
45
  * - Si la fase es 'tiebreak', ejecuta advanceTieBreak().
43
46
  *
@@ -100,13 +103,18 @@ class A_MatchPlay {
100
103
  // -------------------------------------------------------------------------
101
104
  // Ciclo de vida (template method).
102
105
  // -------------------------------------------------------------------------
103
- /** Inicia el partido. Los deportes NO sobreescriben esto; usan `startPlay`. */
104
- start(one, two) {
106
+ /**
107
+ * Inicia el partido. Los deportes NO sobreescriben esto; usan `startPlay`.
108
+ * `one` es el local (en partidos neutrales es sólo nominal, ver `conditions`).
109
+ */
110
+ start(one, two, conditions) {
105
111
  this._teamOne = one;
106
112
  this._teamTwo = two;
113
+ this._conditions = conditions;
107
114
  this._time = 0;
108
115
  this._phase = 'regular';
109
116
  this.startPlay(one, two);
117
+ this.updateRosters();
110
118
  }
111
119
  /**
112
120
  * Avanza un intervalo de simulación. Coordina las fases; los deportes definen
@@ -118,6 +126,8 @@ class A_MatchPlay {
118
126
  }
119
127
  if (this._phase === 'finished')
120
128
  return;
129
+ // El contexto cambia con el partido: los rosters se reevalúan antes de jugar.
130
+ this.updateRosters();
121
131
  if (this._phase === 'regular') {
122
132
  this.advanceRegular();
123
133
  return;
@@ -125,6 +135,27 @@ class A_MatchPlay {
125
135
  // this._phase === 'tiebreak'
126
136
  this.advanceTieBreak();
127
137
  }
138
+ /**
139
+ * Reevalúa los atributos de ambos rosters con el contexto actual.
140
+ *
141
+ * Los dos contextos se construyen ANTES de actualizar cualquiera, a partir de la
142
+ * misma foto del partido, para que el resultado no dependa del orden.
143
+ */
144
+ updateRosters() {
145
+ const one = this._teamOne;
146
+ const two = this._teamTwo;
147
+ const state = {
148
+ time: this._time,
149
+ phase: this._phase,
150
+ result: this._result,
151
+ };
152
+ const serie = this.context;
153
+ const conditions = this._conditions;
154
+ const ctxOne = { side: 'home', conditions, state, opponent: two, serie };
155
+ const ctxTwo = { side: 'away', conditions, state, opponent: one, serie };
156
+ one.update(ctxOne);
157
+ two.update(ctxTwo);
158
+ }
128
159
  advanceRegular() {
129
160
  if (this.regularTimeIsOver()) {
130
161
  this.closeRegularOrEnterTieBreak();
@@ -1 +1 @@
1
- {"version":3,"file":"A_MatchPlay.js","sourceRoot":"","sources":["../../src/Match/A_MatchPlay.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"A_MatchPlay.js","sourceRoot":"","sources":["../../src/Match/A_MatchPlay.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import type { JDateTime } from 'jl-calendar';
2
+ import type { A_TeamRoster } from '../A_TeamRoster';
3
+ import type { A_Result } from './A_Result';
4
+ import type { MatchPlayPhase } from './A_MatchPlay';
5
+ import type { MatchContext } from './A_Serie';
6
+ import type { TMatchScore } from './scores';
7
+ /**
8
+ * Lado del partido que ocupa un roster.
9
+ *
10
+ * `'home'` es siempre `teamOne` de la serie / `homeTeam` del match. En un partido
11
+ * neutral el lado es sólo nominal: la ventaja de local no aplica, y lo indica
12
+ * `MatchConditions.isNeutral`. Por eso ambos datos viajan siempre juntos.
13
+ */
14
+ export type MatchSide = 'home' | 'away';
15
+ /**
16
+ * Condiciones externas en las que se juega el partido (el "dónde y cuándo").
17
+ *
18
+ * Hoy: neutralidad y fecha. Es una interfaz de sólo lectura a propósito: factores
19
+ * como el clima o la sede se agregan acá más adelante (incluso como getters que
20
+ * cambien durante el partido) sin modificar las firmas que ya la consumen.
21
+ */
22
+ export interface MatchConditions {
23
+ readonly isNeutral: boolean;
24
+ readonly date: JDateTime;
25
+ }
26
+ /**
27
+ * Estado vivo del partido en el instante en que se evalúan los rosters.
28
+ * Lo mantiene `A_MatchPlay`; los rosters sólo lo leen.
29
+ */
30
+ export interface MatchState<MS extends TMatchScore> {
31
+ readonly time: number;
32
+ readonly phase: MatchPlayPhase;
33
+ readonly result: A_Result<MS>;
34
+ }
35
+ /**
36
+ * Todo lo que un roster puede mirar para definir sus atributos efectivos.
37
+ *
38
+ * `A_MatchPlay` arma un contexto por lado en cada evaluación, a partir de una misma
39
+ * foto del partido, de modo que el resultado no depende del orden en que se
40
+ * actualicen los dos rosters.
41
+ *
42
+ * - `opponent`: roster rival, de sólo lectura. En la primera evaluación puede no
43
+ * estar resuelto todavía (`opponent.isResolved === false`).
44
+ * - `serie`: vista de la serie, presente sólo si el partido pertenece a una.
45
+ */
46
+ export interface RosterContext<MS extends TMatchScore = TMatchScore> {
47
+ readonly side: MatchSide;
48
+ readonly conditions: MatchConditions;
49
+ readonly state: MatchState<MS>;
50
+ readonly opponent: A_TeamRoster<any>;
51
+ readonly serie?: MatchContext<MS>;
52
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=RosterContext.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RosterContext.js","sourceRoot":"","sources":["../../src/Match/RosterContext.ts"],"names":[],"mappings":""}
package/dist/index.d.ts CHANGED
@@ -11,6 +11,8 @@ export type { IMatchCreationInfo, TypeMatchState } from './Match/A_Match';
11
11
  export type { IResultInfo, IWinnerInfo, TypeTotalScore } from './Match/A_Result';
12
12
  export type { ISerieCreationInfo, MatchContext, MatchContextProvider } from './Match/A_Serie';
13
13
  export type { IMatchScore, TMatchScore } from './Match/scores';
14
+ export type { MatchPlayPhase } from './Match/A_MatchPlay';
15
+ export type { MatchConditions, MatchSide, MatchState, RosterContext } from './Match/RosterContext';
14
16
  export type { IPersonData } from './Person';
15
17
  export type { ITeamCreator, ITeamOwner } from './A_Team';
16
18
  export type { ISportProfile, AnySportProfile } from './profiles/ISportProfile';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jl-sprt-core",
3
- "version": "1.4.0",
3
+ "version": "2.0.0",
4
4
  "description": "",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -21,11 +21,11 @@
21
21
  "license": "ISC",
22
22
  "devDependencies": {
23
23
  "@types/node": "^22.10.0",
24
- "nodemon": "^3.1.14",
24
+ "nodemon": "^3.1.11",
25
25
  "typescript": "~5.4.5",
26
26
  "vitest": "^5.0.0"
27
27
  },
28
28
  "dependencies": {
29
29
  "jl-calendar": "^2.3.0"
30
30
  }
31
- }
31
+ }