docs(core) replace glOptions with deviceProps

[chrisgervang]

Closes #8896

Background

glOptions was removed in v9 and replaced by deviceProps.

Change List

• removes glOptions (this has not been functional since v9)
• docs for device and deviceProps
• upgrade guide
• type as deviceProps: WebGLDeviceProps | WebGPUDeviceProps (need to update luma)

[coveralls]

coverage: 89.671% (-0.001%) from 89.672%
when pulling c4c2139 on chr/device-props-docs
into 9351848 on master.

[Pessimistress]

This will not provide any type hint for WebGL context options. Should be something like this?

DeviceProps & (
  ({type: 'webgl'} & WebGLContextAttributes)
  | {type?: 'webgpu'}
)

[ibgreen]

You may want to specify preserveDrawingBuffer even when omitting Device type or using type: 'best-available'.

[chrisgervang]

Is type optional? What happens when someone doesn't specify the type on deviceProps, and let's deck define the device?

What will luma.createDevice do by default in deck? I think deck only registers a WebGLDevice in this logic but it's just a little unclear reading the code whether type is required, and if not, what that implies in deck?

[coveralls]

coverage: 89.562% (-0.1%) from 89.672%
when pulling cdd6454 on chr/device-props-docs
into 9351848 on master.

[coveralls]

coverage: 89.562% (-0.1%) from 89.672%
when pulling cdd6454 on chr/device-props-docs
into 9351848 on master.

[chrisgervang]

User's can forget to add type: 'webgl'. Any problem with deck adding it by default if the user hasn't specified? Also technically if the user provides type here it's a luma CreateDeviceProps instead of DeviceProps

[coveralls]

coverage: 89.404%. remained the same
when pulling 8d4d4b3 on chr/device-props-docs
into 537f80b on master.

[coveralls]

coverage: 89.252% (-0.2%) from 89.404%
when pulling 23a76b1 on chr/device-props-docs
into 537f80b on master.