componentName: rtgl-tag-select
propsSchema:
  type: object
  properties:
    ariaLabel:
      type: string
    ariaDescription:
      type: string
    ariaInvalid:
      type: boolean
    placeholder:
      type: string
    options:
      type: array
      items:
        type: object
        properties:
          type:
            type: string
            enum:
              - section
              - item
              - separator
          label:
            type: string
          value:
            type: any
          icon:
            type: string
          shortcut:
            type: string
          suffixText:
            type: string
          testId:
            type: string
    selectedValues:
      type: array
      items:
        type: any
    draftSelectedValues:
      type: array
      items:
        type: any
    open:
      type: boolean
    onChange:
      type: function
    addOption:
      type: object
      properties:
        label:
          type: string
    noAdd:
      type: boolean
    disabled:
      type: boolean
    w:
      type: string
events:
  value-change: {}
  draft-value-change: {}
  open-change: {}
  add-option-click: {}
methods:
  type: object
  properties:
    refreshPopover:
      description: Recomputes the open popover position and rerenders the current options and draft values.
      params:
        - values
        - keepOpen
      returns: void
    setDraftSelectedValues:
      description: Replaces the draft-only selection without committing `selectedValues`; optionally reopens the popover around the trigger when `keepOpen` is true.
      params:
        - values
        - keepOpen
      returns: void
    appendDraftSelectedValue:
      description: Adds a value to the draft-only selection without committing `selectedValues`; optionally reopens the popover around the trigger when `keepOpen` is true.
      params:
        - value
        - keepOpen
      returns: void