Break up Parameter interface into the different types/formats

[andrii-balitskyi]

          Really we need to follow what we did for Property and break it up into the difference types/formats.

But that can be the next PR

Originally posted by @razor-x in #62 (comment)

[andrii-balitskyi]

@razor-x should we use interfaces defined for Property something like:

export interface BaseParameter {
  name: string
  isRequired: boolean
  isUndocumented: boolean
  isDeprecated: boolean
  deprecationMessage: string
  description: string
}

export type Parameter =
  | (BaseParameter & StringProperty)
  | (BaseParameter & EnumProperty)
  | (BaseParameter & RecordProperty)
  | (BaseParameter & ListProperty)
  | (BaseParameter & ObjectProperty)
  | (BaseParameter & BooleanProperty)
  | (BaseParameter & DatetimeProperty)
  | (BaseParameter & IdProperty)

[razor-x]

@andrii-balitskyi Yes (but we can use the interface extension pattern we already have). I expect the properties / parameters will share a similar structure at first, but they will diverge as we build the docs/sdks since params are about input and properties are about output.