feat: add documentation comments

Author: eshankvaish

src/Shared/Components/SelectPicker/SelectPicker.component.tsx

@@ -126,6 +126,52 @@ import { SelectPickerOptionType, SelectPickerProps, SelectPickerVariantType } fr
  * ```tsx
  * <SelectPicker ... showSelectedOptionsCount />
  * ```
+ * @example Multi Select
+ * ```tsx
+ * <SelectPicker ... isMulti />
+ * ```
+ *
+ * @example Creatable Multi Select
+ * ```tsx
+ * <SelectPicker
+ *      ...
+ *      isMulti
+ *      multiSelectProps={{
+ *          isCreatable: true
+ *      }}
+ * />
+ * ```
+ *
+ * @example Multi Select with group heading selectable
+ * ```tsx
+ * <SelectPicker
+ *      ...
+ *      isMulti
+ *      multiSelectProps={{
+ *          isGroupHeadingSelectable: true
+ *      }}
+ * />
+ * ```
+ *
+ * @example Multi Select with selected option validator
+ * ```tsx
+ * <SelectPicker
+ *      ...
+ *      isMulti
+ *      multiSelectProps={{
+ *          getIsOptionValid: (option) => boolean
+ *      }}
+ * />
+ * ```
+ *
+ * @example Custom options rendering support (menuIsOpen needs to be handled by consumer)
+ * ```tsx
+ * <SelectPicker
+ *      ...
+ *      shouldRenderCustomOptions
+ *      renderCustomOptions={() => <div />}
+ * />
+ * ```
  */
 const SelectPicker = forwardRef(
     (

src/Shared/Components/SelectPicker/type.ts

@@ -131,7 +131,6 @@ export type SelectPickerProps = Pick<
          * @default false
          */
         disableDescriptionEllipsis?: boolean
-        // TODO: ref support?
     } & (
         | {
               isMulti?: never