ValueSetListItem:
  type: object
  description: Library/system value set summary (from JSON files)
  properties:
    value:
      type: string
      description: The value set key/name
    label:
      type: string
      description: The display name/label
    count:
      type: integer
      description: Number of items in this value set

ValueSetLibItem:
  type: object
  description: Library/system value set item from JSON files
  properties:
    value:
      type: string
      description: The value/key code
    label:
      type: string
      description: The display label

ValueSetDef:
  type: object
  description: User-defined value set definition (from database)
  properties:
    VSetID:
      type: integer
      description: Primary key
    SiteID:
      type: integer
      description: Site reference
    VSName:
      type: string
      description: Value set name
    VSDesc:
      type: string
      description: Value set description
    CreateDate:
      type: string
      format: date-time
      description: Creation timestamp
    EndDate:
      type: string
      format: date-time
      nullable: true
      description: Soft delete timestamp
    ItemCount:
      type: integer
      description: Number of items in this value set

ValueSetItem:
  type: object
  description: User-defined value set item (from database)
  properties:
    VID:
      type: integer
      description: Primary key
    SiteID:
      type: integer
      description: Site reference
    VSetID:
      type: integer
      description: Reference to value set definition
    VOrder:
      type: integer
      description: Display order
    VValue:
      type: string
      description: The value code
    VDesc:
      type: string
      description: The display description/label
    VCategory:
      type: string
      description: Category code
    CreateDate:
      type: string
      format: date-time
      description: Creation timestamp
    EndDate:
      type: string
      format: date-time
      nullable: true
      description: Soft delete timestamp
    VSName:
      type: string
      description: Value set name (from joined definition)
