mini_arcade_core.scenes.systems.builtins.timers

Reusable timed-state helpers for temporary gameplay states.

Classes

TimedState	Mutable state for one temporary status window.
TimedStateBinding	Declarative timed-state decay rule.
TimedStateSystem	Decay active timed states using frame dt.

Functions

activate_timed_state(→ None)	Activate a timed state and reset its countdown.
clear_timed_state(→ None)	Clear a timed state immediately.

Module Contents

class mini_arcade_core.scenes.systems.builtins.timers.TimedState

Mutable state for one temporary status window.

active: bool = False

remaining_seconds: float = 0.0

tag: str = ''

payload: Any = None

mini_arcade_core.scenes.systems.builtins.timers.activate_timed_state(state: TimedState, *, duration_seconds: float, tag: str = '', payload: Any = None) → None

Activate a timed state and reset its countdown.

mini_arcade_core.scenes.systems.builtins.timers.clear_timed_state(state: TimedState) → None

Clear a timed state immediately.

class mini_arcade_core.scenes.systems.builtins.timers.TimedStateBinding

Bases: Generic[TCtx]

Declarative timed-state decay rule.

state_getter: Callable[[TCtx], TimedState]

on_expired: Callable[[TCtx, TimedState], None] | None = None

class mini_arcade_core.scenes.systems.builtins.timers.TimedStateSystem

Bases: Generic[TCtx]

Decay active timed states using frame dt.

name: str = 'common_timed_state'

phase: int

order: int = 16

enabled_when: Callable[[TCtx], bool]

bindings: tuple[TimedStateBinding[TCtx], Ellipsis] = ()

step(ctx: TCtx) → None

Advance active timed states by the current frame delta.