typescript enhancement for widget components

[jsjames]

Dependent on #4340

Adds auto-generated type guards and conversions for components and component configs.

• isConfig(config) is added as a type conversion function which can be used to validate and convert the type to a appropriate typescript config type.
• isComponent(component, defaultConfig) can be used to validate a component is of the correct type and converts to the appropriate typescript component type and also the appropriate config type.

Example use:

import { OhCanvasLayer as OhCanvasLayerType, OhCanvasLayout as OhCanvasLayoutType, OhSvgElement } from '@/types/components/widgets'

...

// validate and layer will now be recognized as type OhCanvasLayerType.Component (and its config as OhCanvasLayerType.Config)
if (OhCanvasLayerType.isComponent(layer, {}))

...

const { config: rawConfig, childContext, slots } = useWidgetContext(context)

// config will now be validated and recognized as OhCanvasLayoutType.Config
const config = computed(() => {
  const raw = rawConfig.value
  if(OhCanvasLayoutType.isConfig(raw)) {
    return raw
  }

Custom config validation can also be added to generate-widget-component-ts.config.js

[relativeci]

#5976 Bundle Size — 13.88MiB (~+0.01%).

1152b35(current) vs 36efc97 main#5975(baseline)

Warning

Bundle contains 2 duplicate packages – View duplicate packages

Bundle metrics   4 changes 1 improvement

	Current #5976	Baseline #5975
Initial JS	1.47MiB(~-0.01%)	1.47MiB
Initial CSS	0B	0B
Cache Invalidation	0%	0%
Chunks	844(+0.12%)	843
Assets	983(+0.1%)	982
Modules	2743(+0.04%)	2742
Duplicate Modules	0	0
Duplicate Code	0%	0%
Packages	122	122
Duplicate Packages	1	1

Bundle size by type   1 change 1 regression

	Current #5976	Baseline #5975
JS	11.57MiB (~+0.01%)	11.57MiB
CSS	906.49KiB	906.49KiB
IMG	638.41KiB	638.41KiB
Fonts	526.1KiB	526.1KiB
Media	295.6KiB	295.6KiB
Other	847B	847B

Bundle analysis report Branch jsjames:create-guards Project dashboard

---

^{Generated by RelativeCI Documentation Report issue}