Advanced optical simulation tools in the OASYS suite and their applications to the design of last generation synchrotron radiation beamlines. Issue 1 (1st December 2022)