exposed configuration and event handler