feat: add components for individual schema properties [KHCP-11732]

[vaibhavrajsingh2001]

Summary

Here is an example SchemaObject :

const sampleSchemaObject: SchemaObject = {
  title: 'sample-title',
  properties: {
    name: {
      type: 'string',
      description: 'sample-description',
      example: 'lorem ipsum',
      enum: ['sample-enum'],
      pattern: '^[0-9]{3}$',
      minimum: 100,
    },
  },
}

here, name is one of the properties of the sampleSchemaObject. The name property has fields like type, description, enum, example, etc.

This PR aims to add individual components for these fields of the property of a Schema Object.

Changes

• Add components for fields of a property
• ModelProperties component →
  • Rename the ModelProperties component to ModelProperty, since now it handles a single property instead of the entire properties object
  • Refactor it to iterate over the fields of a single property and dynamically render components for those fields
  • Add a map of field name to component type, and a method to compute props for that component
  • Merge rendering of properties of nested object and array items into a single detail-summary
  • Add a orderedFieldList util to fix the order in which fields are rendered
• Move out various util methods out of components to utils/schema-model.ts
• Add tests for components and utils

[ValeryG]

This is do not like: utils importing components ....

[vaibhavrajsingh2001]

Fixed. Moved it to be a computed property inside ModelProperty

[vaibhavrajsingh2001]

Background:
#33 (comment)

if the type of propertyName is a string, why do we need toString here?

@adamdehaven turns out it's because openapi3-ts has typed properties as a mapped type { [propertyName: string]: SchemaObject | ReferenceObject }, instead of a Record<string, SchemaObject | ReferenceObject>

It's a known TS quirk that keys in a mapped type will always be interpreted as string | number. Ref: microsoft/TypeScript#48269

[vaibhavrajsingh2001]

Have opened a PR in openapi3-ts to fix this

metadevpro/openapi3-ts#135

[kongponents-bot]

🎉 This PR is included in version 1.3.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀