fix(process): rework

[siriuslatte]

Description

Proposed Changes

• Rework to Scheduler (breaking changes, a complete rework to the API & optimizations)
• Rework to Process (not breaking changes to existing code)
• Ticks per second configuration individually for Processes
• Status method, which indicates the current status of the process

Tasks

• Rework done
• Tests Created
• Tests Passing

Documentation

• Documentation written
• Documentation submitted
• Documentation published

Notes

No more details, a review on this is required.

Linked

No linked issues.

[christopher-buss]

Can execution group be the same as in the ECS? It seems weird to have the same name in two places but supporting different functionality

[siriuslatte]

I was thinking on this as well, I was going to discuss this with Luna, if processes can be the same as Systems as in the ECS.

[siriuslatte]

Docs being made for this on morning.

[siriuslatte]

This worths giving it a show, current way of interacting with a process.

/**
 * Schedulers
 */
class PreHighScheduler extends Scheduler {
    constructor() {
        super();

        this.executionGroup = RunService.PreSimulation;
    }

    /** Methods of your own */
}

export const CameraScheduler = new PreHighScheduler()

CameraScheduler.schedule(process: Process); // Schedules a new process to the current scheduler.
CameraScheduler.unschedule(process: Process); // Unschedules the process within the next resumption cycle

CameraScheduler.suspend(process: Process, nOfTicks: number); // Suspends specified process.
CameraScheduler.unsuspend(process: Process); // Unsuspends process within the next resumption cycle

CameraScheduler.has(process: Process); // Checks whether the process is owned by this Scheduler.
CameraScheduler.isSuspended(process: Process); // Returns true if the process it's suspended.

CameraScheduler.stop(); // Stops all current on-going tasks.
CameraScheduler.resume(); // Resumes Scheduler.
 
/**
 * Processes
 */
class BuildingCameraProcess extends Process {
    constructor() {
        super()

        this.scheduler = CameraScheduler;
    }

    public override update(): void {
        ...moveCamera;
    }
}

// Whenever the process is needed, it shall be created.
OnInput(() => {
    const CameraProcess = new BuildingCameraProcess();

    CameraProcess.suspend(nOfTicks: number); // Suspends current process n amount of ticks.
    CameraProcess.resume(); // Resumes current process (deferred to the end of the current resumption cycle).
    CameraProcess.status(); // Returns current status of the Process (active | dead | suspended | unknown).
    CameraProcess.delete(); // Unschedules itself from its scheduler.
})