add relevantBlock function (#1100)

* feat: current block

* pass full rundown to functions and use filter utils

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

@@ -0,0 +1,7 @@
+import type { MaybeNumber } from '../../utils/utils.type.js';
+import type { OntimeBlock } from '../core/OntimeEvent.type.js';
+
+export type CurrentBlockState = {
+  block: OntimeBlock | null;
+  startedAt: MaybeNumber;
+};

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

@@ -1,5 +1,6 @@
 import type { OntimeEvent } from '../core/OntimeEvent.type.js';
 import type { SimpleTimerState } from './AuxTimer.type.js';
+import type { CurrentBlockState } from './CurrentBlockState.type.js';
 import type { MessageState } from './MessageControl.type.js';
 import type { Runtime } from './Runtime.type.js';
 import type { TimerState } from './TimerState.type.js';
@@ -15,6 +16,7 @@ export type RuntimeStore = {
 
   // rundown data
   runtime: Runtime;
+  currentBlock: CurrentBlockState;
   eventNow: OntimeEvent | null;
   publicEventNow: OntimeEvent | null;
   eventNext: OntimeEvent | null;

packages/types/src/index.ts

@@ -62,6 +62,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, TimerPhase } from './definitions/runtime/TimerState.type.js';
+export type { CurrentBlockState } from './definitions/runtime/CurrentBlockState.type.js';
 
 // ---> Extra Timer
 export { type SimpleTimerState, SimplePlayback, SimpleDirection } from './definitions/runtime/AuxTimer.type.js';