refactor: declare timer phase

packages/types/src/definitions/runtime/TimerState.type.ts

@@ -1,6 +1,14 @@
 import type { MaybeNumber } from '../../index.js';
 import type { Playback } from './Playback.type.js';
 
+export enum TimerPhase {
+  None = 'none',
+  Default = 'default',
+  Warning = 'warning',
+  Danger = 'danger',
+  Negative = 'negative',
+}
+
 export type TimerState = {
   addedTime: number; // time added by user, can be negative
   current: MaybeNumber; // running countdown
@@ -8,6 +16,7 @@ export type TimerState = {
   elapsed: MaybeNumber; // elapsed time in current timer
   expectedFinish: MaybeNumber; // time we expect timer to finish
   finishedAt: MaybeNumber; // only if timer has already finished
+  phase: TimerPhase;
   playback: Playback;
   secondaryTimer: MaybeNumber; // used for roll mode
   startedAt: MaybeNumber; // only if timer has already started

packages/types/src/index.ts

@@ -60,7 +60,7 @@ export type { Message, TimerMessage, MessageState } from './definitions/runtime/
 
 export type { Runtime } from './definitions/runtime/Runtime.type.js';
 export type { RuntimeStore } from './definitions/runtime/RuntimeStore.type.js';
-export type { TimerState } from './definitions/runtime/TimerState.type.js';
+export { type TimerState, TimerPhase } from './definitions/runtime/TimerState.type.js';
 
 // ---> Extra Timer
 export { type SimpleTimerState, SimplePlayback, SimpleDirection } from './definitions/runtime/AuxTimer.type.js';