openapi

-- type.yaml --
components:
  schemas:
    User:
      description: "A User uses something."
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        address:
          $ref: "#/components/schemas/PhoneNumber"
          nullable: true
    PhoneNumber:
      description: "The number to dial."
      type: string

-- out.cue --
// A User uses something.
#User: {
	id?:   int
	name?: string
	address?:
		null | #PhoneNumber
	...
}

// The number to dial.
#PhoneNumber: string