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.
- package/dist/A_TeamRoster.d.ts +29 -3
- package/dist/A_TeamRoster.js +34 -2
- package/dist/A_TeamRoster.js.map +1 -1
- package/dist/Match/A_Match.d.ts +2 -0
- package/dist/Match/A_Match.js +3 -1
- package/dist/Match/A_Match.js.map +1 -1
- package/dist/Match/A_MatchPlay.d.ts +75 -2
- package/dist/Match/A_MatchPlay.js +91 -2
- package/dist/Match/A_MatchPlay.js.map +1 -1
- package/dist/Match/RosterContext.d.ts +52 -0
- package/dist/Match/RosterContext.js +3 -0
- package/dist/Match/RosterContext.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/package.json +3 -3
package/dist/A_TeamRoster.d.ts
CHANGED
|
@@ -1,9 +1,35 @@
|
|
|
1
|
-
|
|
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
|
|
4
|
-
private
|
|
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
|
}
|
package/dist/A_TeamRoster.js
CHANGED
|
@@ -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.
|
|
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 {
|
package/dist/A_TeamRoster.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"A_TeamRoster.js","sourceRoot":"","sources":["../src/A_TeamRoster.ts"],"names":[],"mappings":";;;
|
|
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"}
|
package/dist/Match/A_Match.d.ts
CHANGED
|
@@ -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
|
package/dist/Match/A_Match.js
CHANGED
|
@@ -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;
|
|
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
|
-
/**
|
|
51
|
-
|
|
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
|
-
/**
|
|
46
|
-
|
|
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":";;;
|
|
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 @@
|
|
|
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": "
|
|
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.
|
|
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
|
+
}
|