cmake: extensions: introduce zephyr_syscall_include_directories

Add a new CMake helper to add new include directories to be parsed by
the syscall machinery. This helper complements the existing
zephyr_syscall_header, which works at a header-level.

Signed-off-by: Gerard Marull-Paretas <gerard@teslabs.com>