jl-sprt-core 1.3.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,9 +1,35 @@
1
- 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> {
2
20
  private _id;
3
- private _starters;
4
- private _subs;
21
+ private _atts;
22
+ private _resolved;
5
23
  constructor(id: string);
6
24
  get id(): string;
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;
7
33
  }
8
34
  export declare class Player {
9
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 {
22
+ // private _starters: Player[] = [];
23
+ // private _subs: Player[] = [];
5
24
  constructor(id) {
6
- this._starters = [];
7
- this._subs = [];
25
+ this._resolved = false;
8
26
  this._id = id;
9
27
  }
10
28
  get id() { return this._id; }
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":";;;AAAA,MAAsB,YAAY;IAIjC,YAAY,EAAU;QAFd,cAAS,GAAa,EAAE,CAAC;QACzB,UAAK,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,EAAE,KAAY,OAAO,IAAI,CAAC,GAAG,CAAA,CAAA,CAAC;CAClC;AATD,oCASC;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.
@@ -33,12 +34,74 @@ export type MatchPlayPhase = 'regular' | 'tiebreak' | 'finished';
33
34
  *
34
35
  * MS: tipo del score del partido. TR: roster del deporte.
35
36
  */
37
+ /**
38
+ * FLUJO DE SIMULACIÓN DEL PARTIDO
39
+ *
40
+ * 1. INICIO — start(one, two, conditions)
41
+ * - Asigna los dos equipos (`one` es el local) y las condiciones del partido.
42
+ * - Inicializa el tiempo en 0.
43
+ * - Establece la fase 'regular'.
44
+ * - Ejecuta startPlay(), que inicializa el estado específico del deporte
45
+ * y crea el resultado del partido.
46
+ * - Evalúa por primera vez los rosters (updateRosters()).
47
+ *
48
+ * 2. AVANCE — advance()
49
+ * - Verifica que el partido haya sido iniciado.
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.
53
+ * - Si la fase es 'regular', ejecuta advanceRegular().
54
+ * - Si la fase es 'tiebreak', ejecuta advanceTieBreak().
55
+ *
56
+ * 3. TIEMPO REGLAMENTARIO — advanceRegular()
57
+ * - Comprueba si terminó el tiempo reglamentario.
58
+ * - Si terminó, evalúa si corresponde finalizar o entrar en desempate.
59
+ * - Si no terminó, ejecuta playRegularInterval().
60
+ * - Después del intervalo, vuelve a comprobar si terminó el tiempo.
61
+ * - Si terminó, evalúa nuevamente la transición de fase.
62
+ *
63
+ * 4. DECISIÓN DE TRANSICIÓN — closeRegularOrEnterTieBreak()
64
+ * - Comprueba si el deporte contempla desempate (hasTieBreak()).
65
+ * - Si lo contempla, comprueba si es necesario desempatar
66
+ * (mustPlayTieBreak()).
67
+ * - mustPlayTieBreak() consulta el contexto de la serie:
68
+ * a) Si no existe contexto, no se requiere desempate.
69
+ * b) Si el partido no puede decidir la serie, no se requiere desempate.
70
+ * c) Si puede decidirla y el resultado actual todavía no define
71
+ * la serie, se requiere desempate.
72
+ * - Si corresponde desempatar, cambia la fase a 'tiebreak'.
73
+ * - En caso contrario, cambia la fase a 'finished'.
74
+ *
75
+ * 5. DESEMPATE — advanceTieBreak()
76
+ * - Ejecuta playTieBreakInterval().
77
+ * - Comprueba si el desempate ya definió un ganador
78
+ * (tieBreakIsResolved()).
79
+ * - Si está resuelto, cambia la fase a 'finished'.
80
+ * - Si no está resuelto, permanece en 'tiebreak' para el siguiente avance.
81
+ *
82
+ * 6. FINALIZACIÓN
83
+ * - El partido termina cuando la fase alcanza 'finished'.
84
+ * - Las llamadas posteriores a advance() no producen cambios.
85
+ *
86
+ * RESPONSABILIDADES:
87
+ * - A_MatchPlay: coordina el ciclo de vida y las transiciones de fase.
88
+ * - Cada deporte: implementa la inicialización, los intervalos y las
89
+ * condiciones de finalización del tiempo reglamentario y del desempate.
90
+ * - MatchContext: proporciona la información necesaria para determinar
91
+ * si el resultado del partido define o no la serie.
92
+ *
93
+ * IMPORTANTE:
94
+ * La lógica de desempate no implementa las reglas de la serie.
95
+ * A_MatchPlay delega esa decisión en MatchContext, que obtiene sus
96
+ * criterios de A_Serie.
97
+ */
36
98
  export declare abstract class A_MatchPlay<MS extends TMatchScore, TR extends A_TeamRoster> {
37
99
  protected _time: number;
38
100
  protected _result: A_Result<MS> | undefined;
39
101
  protected _teamOne: TR | undefined;
40
102
  protected _teamTwo: TR | undefined;
41
103
  protected _contextProvider?: MatchContextProvider<MS>;
104
+ protected _conditions: MatchConditions | undefined;
42
105
  protected _phase: MatchPlayPhase;
43
106
  constructor(contextProvider?: MatchContextProvider<MS>);
44
107
  get time(): number;
@@ -47,13 +110,23 @@ export declare abstract class A_MatchPlay<MS extends TMatchScore, TR extends A_T
47
110
  get context(): MatchContext<MS> | undefined;
48
111
  /** El partido terminó cuando alcanzó la fase 'finished'. */
49
112
  get isFinished(): boolean;
50
- /** Inicia el partido. Los deportes NO sobreescriben esto; usan `startPlay`. */
51
- 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;
52
118
  /**
53
119
  * Avanza un intervalo de simulación. Coordina las fases; los deportes definen
54
120
  * qué ocurre dentro de cada fase vía los hooks.
55
121
  */
56
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;
57
130
  private advanceRegular;
58
131
  private closeRegularOrEnterTieBreak;
59
132
  private advanceTieBreak;
@@ -25,6 +25,67 @@ exports.A_MatchPlay = void 0;
25
25
  *
26
26
  * MS: tipo del score del partido. TR: roster del deporte.
27
27
  */
28
+ /**
29
+ * FLUJO DE SIMULACIÓN DEL PARTIDO
30
+ *
31
+ * 1. INICIO — start(one, two, conditions)
32
+ * - Asigna los dos equipos (`one` es el local) y las condiciones del partido.
33
+ * - Inicializa el tiempo en 0.
34
+ * - Establece la fase 'regular'.
35
+ * - Ejecuta startPlay(), que inicializa el estado específico del deporte
36
+ * y crea el resultado del partido.
37
+ * - Evalúa por primera vez los rosters (updateRosters()).
38
+ *
39
+ * 2. AVANCE — advance()
40
+ * - Verifica que el partido haya sido iniciado.
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.
44
+ * - Si la fase es 'regular', ejecuta advanceRegular().
45
+ * - Si la fase es 'tiebreak', ejecuta advanceTieBreak().
46
+ *
47
+ * 3. TIEMPO REGLAMENTARIO — advanceRegular()
48
+ * - Comprueba si terminó el tiempo reglamentario.
49
+ * - Si terminó, evalúa si corresponde finalizar o entrar en desempate.
50
+ * - Si no terminó, ejecuta playRegularInterval().
51
+ * - Después del intervalo, vuelve a comprobar si terminó el tiempo.
52
+ * - Si terminó, evalúa nuevamente la transición de fase.
53
+ *
54
+ * 4. DECISIÓN DE TRANSICIÓN — closeRegularOrEnterTieBreak()
55
+ * - Comprueba si el deporte contempla desempate (hasTieBreak()).
56
+ * - Si lo contempla, comprueba si es necesario desempatar
57
+ * (mustPlayTieBreak()).
58
+ * - mustPlayTieBreak() consulta el contexto de la serie:
59
+ * a) Si no existe contexto, no se requiere desempate.
60
+ * b) Si el partido no puede decidir la serie, no se requiere desempate.
61
+ * c) Si puede decidirla y el resultado actual todavía no define
62
+ * la serie, se requiere desempate.
63
+ * - Si corresponde desempatar, cambia la fase a 'tiebreak'.
64
+ * - En caso contrario, cambia la fase a 'finished'.
65
+ *
66
+ * 5. DESEMPATE — advanceTieBreak()
67
+ * - Ejecuta playTieBreakInterval().
68
+ * - Comprueba si el desempate ya definió un ganador
69
+ * (tieBreakIsResolved()).
70
+ * - Si está resuelto, cambia la fase a 'finished'.
71
+ * - Si no está resuelto, permanece en 'tiebreak' para el siguiente avance.
72
+ *
73
+ * 6. FINALIZACIÓN
74
+ * - El partido termina cuando la fase alcanza 'finished'.
75
+ * - Las llamadas posteriores a advance() no producen cambios.
76
+ *
77
+ * RESPONSABILIDADES:
78
+ * - A_MatchPlay: coordina el ciclo de vida y las transiciones de fase.
79
+ * - Cada deporte: implementa la inicialización, los intervalos y las
80
+ * condiciones de finalización del tiempo reglamentario y del desempate.
81
+ * - MatchContext: proporciona la información necesaria para determinar
82
+ * si el resultado del partido define o no la serie.
83
+ *
84
+ * IMPORTANTE:
85
+ * La lógica de desempate no implementa las reglas de la serie.
86
+ * A_MatchPlay delega esa decisión en MatchContext, que obtiene sus
87
+ * criterios de A_Serie.
88
+ */
28
89
  class A_MatchPlay {
29
90
  constructor(contextProvider) {
30
91
  this._phase = 'regular';
@@ -42,13 +103,18 @@ class A_MatchPlay {
42
103
  // -------------------------------------------------------------------------
43
104
  // Ciclo de vida (template method).
44
105
  // -------------------------------------------------------------------------
45
- /** Inicia el partido. Los deportes NO sobreescriben esto; usan `startPlay`. */
46
- 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) {
47
111
  this._teamOne = one;
48
112
  this._teamTwo = two;
113
+ this._conditions = conditions;
49
114
  this._time = 0;
50
115
  this._phase = 'regular';
51
116
  this.startPlay(one, two);
117
+ this.updateRosters();
52
118
  }
53
119
  /**
54
120
  * Avanza un intervalo de simulación. Coordina las fases; los deportes definen
@@ -60,6 +126,8 @@ class A_MatchPlay {
60
126
  }
61
127
  if (this._phase === 'finished')
62
128
  return;
129
+ // El contexto cambia con el partido: los rosters se reevalúan antes de jugar.
130
+ this.updateRosters();
63
131
  if (this._phase === 'regular') {
64
132
  this.advanceRegular();
65
133
  return;
@@ -67,6 +135,27 @@ class A_MatchPlay {
67
135
  // this._phase === 'tiebreak'
68
136
  this.advanceTieBreak();
69
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
+ }
70
159
  advanceRegular() {
71
160
  if (this.regularTimeIsOver()) {
72
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.3.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
+ }