jl-sprt-core 1.3.0 → 1.4.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,13 @@
1
+ export interface TeamAttributes {
2
+ attack: number;
3
+ defense: number;
4
+ }
1
5
  export declare abstract class A_TeamRoster {
2
6
  private _id;
3
- private _starters;
4
- private _subs;
5
- constructor(id: string);
7
+ private _attributes;
8
+ constructor(id: string, atts: TeamAttributes);
6
9
  get id(): string;
10
+ get atts(): TeamAttributes;
7
11
  }
8
12
  export declare class Player {
9
13
  }
@@ -2,12 +2,12 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.Player = exports.A_TeamRoster = void 0;
4
4
  class A_TeamRoster {
5
- constructor(id) {
6
- this._starters = [];
7
- this._subs = [];
5
+ constructor(id, atts) {
8
6
  this._id = id;
7
+ this._attributes = { ...atts };
9
8
  }
10
9
  get id() { return this._id; }
10
+ get atts() { return this._attributes; }
11
11
  }
12
12
  exports.A_TeamRoster = A_TeamRoster;
13
13
  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":";;;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"}
@@ -33,6 +33,64 @@ export type MatchPlayPhase = 'regular' | 'tiebreak' | 'finished';
33
33
  *
34
34
  * MS: tipo del score del partido. TR: roster del deporte.
35
35
  */
36
+ /**
37
+ * FLUJO DE SIMULACIÓN DEL PARTIDO
38
+ *
39
+ * 1. INICIO — start(one, two)
40
+ * - Asigna los dos equipos.
41
+ * - Inicializa el tiempo en 0.
42
+ * - Establece la fase 'regular'.
43
+ * - Ejecuta startPlay(), que inicializa el estado específico del deporte
44
+ * y crea el resultado del partido.
45
+ *
46
+ * 2. AVANCE — advance()
47
+ * - Verifica que el partido haya sido iniciado.
48
+ * - Si la fase es 'finished', no hace nada.
49
+ * - Si la fase es 'regular', ejecuta advanceRegular().
50
+ * - Si la fase es 'tiebreak', ejecuta advanceTieBreak().
51
+ *
52
+ * 3. TIEMPO REGLAMENTARIO — advanceRegular()
53
+ * - Comprueba si terminó el tiempo reglamentario.
54
+ * - Si terminó, evalúa si corresponde finalizar o entrar en desempate.
55
+ * - Si no terminó, ejecuta playRegularInterval().
56
+ * - Después del intervalo, vuelve a comprobar si terminó el tiempo.
57
+ * - Si terminó, evalúa nuevamente la transición de fase.
58
+ *
59
+ * 4. DECISIÓN DE TRANSICIÓN — closeRegularOrEnterTieBreak()
60
+ * - Comprueba si el deporte contempla desempate (hasTieBreak()).
61
+ * - Si lo contempla, comprueba si es necesario desempatar
62
+ * (mustPlayTieBreak()).
63
+ * - mustPlayTieBreak() consulta el contexto de la serie:
64
+ * a) Si no existe contexto, no se requiere desempate.
65
+ * b) Si el partido no puede decidir la serie, no se requiere desempate.
66
+ * c) Si puede decidirla y el resultado actual todavía no define
67
+ * la serie, se requiere desempate.
68
+ * - Si corresponde desempatar, cambia la fase a 'tiebreak'.
69
+ * - En caso contrario, cambia la fase a 'finished'.
70
+ *
71
+ * 5. DESEMPATE — advanceTieBreak()
72
+ * - Ejecuta playTieBreakInterval().
73
+ * - Comprueba si el desempate ya definió un ganador
74
+ * (tieBreakIsResolved()).
75
+ * - Si está resuelto, cambia la fase a 'finished'.
76
+ * - Si no está resuelto, permanece en 'tiebreak' para el siguiente avance.
77
+ *
78
+ * 6. FINALIZACIÓN
79
+ * - El partido termina cuando la fase alcanza 'finished'.
80
+ * - Las llamadas posteriores a advance() no producen cambios.
81
+ *
82
+ * RESPONSABILIDADES:
83
+ * - A_MatchPlay: coordina el ciclo de vida y las transiciones de fase.
84
+ * - Cada deporte: implementa la inicialización, los intervalos y las
85
+ * condiciones de finalización del tiempo reglamentario y del desempate.
86
+ * - MatchContext: proporciona la información necesaria para determinar
87
+ * si el resultado del partido define o no la serie.
88
+ *
89
+ * IMPORTANTE:
90
+ * La lógica de desempate no implementa las reglas de la serie.
91
+ * A_MatchPlay delega esa decisión en MatchContext, que obtiene sus
92
+ * criterios de A_Serie.
93
+ */
36
94
  export declare abstract class A_MatchPlay<MS extends TMatchScore, TR extends A_TeamRoster> {
37
95
  protected _time: number;
38
96
  protected _result: A_Result<MS> | undefined;
@@ -25,6 +25,64 @@ 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)
32
+ * - Asigna los dos equipos.
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
+ *
38
+ * 2. AVANCE — advance()
39
+ * - Verifica que el partido haya sido iniciado.
40
+ * - Si la fase es 'finished', no hace nada.
41
+ * - Si la fase es 'regular', ejecuta advanceRegular().
42
+ * - Si la fase es 'tiebreak', ejecuta advanceTieBreak().
43
+ *
44
+ * 3. TIEMPO REGLAMENTARIO — advanceRegular()
45
+ * - Comprueba si terminó el tiempo reglamentario.
46
+ * - Si terminó, evalúa si corresponde finalizar o entrar en desempate.
47
+ * - Si no terminó, ejecuta playRegularInterval().
48
+ * - Después del intervalo, vuelve a comprobar si terminó el tiempo.
49
+ * - Si terminó, evalúa nuevamente la transición de fase.
50
+ *
51
+ * 4. DECISIÓN DE TRANSICIÓN — closeRegularOrEnterTieBreak()
52
+ * - Comprueba si el deporte contempla desempate (hasTieBreak()).
53
+ * - Si lo contempla, comprueba si es necesario desempatar
54
+ * (mustPlayTieBreak()).
55
+ * - mustPlayTieBreak() consulta el contexto de la serie:
56
+ * a) Si no existe contexto, no se requiere desempate.
57
+ * b) Si el partido no puede decidir la serie, no se requiere desempate.
58
+ * c) Si puede decidirla y el resultado actual todavía no define
59
+ * la serie, se requiere desempate.
60
+ * - Si corresponde desempatar, cambia la fase a 'tiebreak'.
61
+ * - En caso contrario, cambia la fase a 'finished'.
62
+ *
63
+ * 5. DESEMPATE — advanceTieBreak()
64
+ * - Ejecuta playTieBreakInterval().
65
+ * - Comprueba si el desempate ya definió un ganador
66
+ * (tieBreakIsResolved()).
67
+ * - Si está resuelto, cambia la fase a 'finished'.
68
+ * - Si no está resuelto, permanece en 'tiebreak' para el siguiente avance.
69
+ *
70
+ * 6. FINALIZACIÓN
71
+ * - El partido termina cuando la fase alcanza 'finished'.
72
+ * - Las llamadas posteriores a advance() no producen cambios.
73
+ *
74
+ * RESPONSABILIDADES:
75
+ * - A_MatchPlay: coordina el ciclo de vida y las transiciones de fase.
76
+ * - Cada deporte: implementa la inicialización, los intervalos y las
77
+ * condiciones de finalización del tiempo reglamentario y del desempate.
78
+ * - MatchContext: proporciona la información necesaria para determinar
79
+ * si el resultado del partido define o no la serie.
80
+ *
81
+ * IMPORTANTE:
82
+ * La lógica de desempate no implementa las reglas de la serie.
83
+ * A_MatchPlay delega esa decisión en MatchContext, que obtiene sus
84
+ * criterios de A_Serie.
85
+ */
28
86
  class A_MatchPlay {
29
87
  constructor(contextProvider) {
30
88
  this._phase = 'regular';
@@ -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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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jl-sprt-core",
3
- "version": "1.3.0",
3
+ "version": "1.4.0",
4
4
  "description": "",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",