//
//  JYPulleyViewController.h
//  JYPulleyController
//
//  Created by JunpuChen on 2018/7/30.
//  Copyright © 2018年 earnestLin. All rights reserved.
//

#import <UIKit/UIKit.h>

@class JYPulleyViewController;

NS_ASSUME_NONNULL_BEGIN

/// 伸缩状态
typedef NS_OPTIONS(NSUInteger, JYPulleyStatus) {
    JYPulleyStatusNone = 1 << 0,            // 不在可视范围
    JYPulleyStatusClosed = 1 << 1,          // 收起
    JYPulleyStatusPartiallyExpand = 1 << 2, // 部分展开
    JYPulleyStatusExpand = 1 << 3,          // 全部展开
};

/// 主内容视图数据源协议
@protocol JYPulleyContentDataSource <NSObject>

/// 主内容试图
- (UIView *)view;

@end

/// 抽屉视图数据源协议
@protocol JYPulleyDrawerDataSource <NSObject>

/// 抽屉视图
- (UIView *)view;

@optional

/// 关闭状态的高度
- (CGFloat)closedHeightInPulleyViewController:(JYPulleyViewController *)pulleyViewController;

/// 部分展开状态的高度
- (CGFloat)partiallyExpandHeightInPulleyViewController:
    (JYPulleyViewController *)pulleyViewController;

/// 全部展开状态的高度
- (CGFloat)expandHeightInPulleyViewController:(JYPulleyViewController *)pulleyViewController;

@end

/// 抽屉视图代理
@protocol JYPulleyDrawerDelegate <NSObject>

@optional

/**
 当抽屉视图状态改变时回调

 @param pulleyViewController pulleyViewController
 @param status 改变后的状态，该状态是唯一的，不存在位移
 */
- (void)pulleyViewController:(JYPulleyViewController *)pulleyViewController
             didChangeStatus:(JYPulleyStatus)status;

/**
 实时回调抽屉视图的滚动进度

 @param pulleyViewController pulleyViewController
 @param progress 滚动进度：0 - 1
 */
- (void)pulleyViewController:(JYPulleyViewController *)pulleyViewController
      drawerDraggingProgress:(CGFloat)progress;

@end

/**
 处理抽屉视图中 scrollView 的协议
    * 当抽屉视图即：drawerDataSource.view 中存在 scrollView 时，需要将 scrollView 中 offset 的改变实
      时传入该方法
    * 默认 JYPulleyViewController 会遵守该协议，并控制抽屉视图中的 scrollView 的可滚动状态
    * 以保证 抽屉视图的拉伸 和 抽屉视图中的 scrollView 保持联动
 */
@protocol JYPulleyDrawerScrollViewDelegate <NSObject>

/// 抽屉视图中的 scrollView 的 offset 改变时
- (void)drawerScrollViewDidScroll:(UIScrollView *)scrollView;

@end

/**
 提供一种类似 iOS10 以上系统地图相类似的控件，底部拥有一个可上拉的抽屉视图
 */
@interface JYPulleyViewController : UIViewController <JYPulleyDrawerScrollViewDelegate>

/// 主内容视图数据源
@property (nonatomic, strong) id<JYPulleyContentDataSource> contentDataSource;

/// 抽屉视图数据源
@property (nonatomic, strong) id<JYPulleyDrawerDataSource> drawerDataSource;

/// 抽屉视图代理
@property (nullable, nonatomic, strong) id<JYPulleyDrawerDelegate> drawerDelegate;

/// 当前状态，注意：当前状态是唯一的，不存在位移
@property (nonatomic, assign, readonly) JYPulleyStatus currentStatus;

/// 支持的状态，可以同时传入多种状态，默认：全部支持
@property (nonatomic, assign) JYPulleyStatus supportedStatus;

/**
 抽屉视图关闭状态高度
 当 drawerDataSource 没有实现 closedHeightInPulleyViewController 时使用该值
 默认：68
 */
@property (nonatomic, assign) CGFloat drawerClosedHeight;

/**
 抽屉视图部分展开状态高度
 当 drawerDataSource 没有实现 partiallyExpandHeightInPulleyViewController 时使用该值
 默认：264
 */
@property (nonatomic, assign) CGFloat drawerPartiallyExpandHeight;

/**
 抽屉视图部分展开状态高度
 当 drawerDataSource 没有实现 expandHeightInPulleyViewController 时使用该值
 默认：占满整个屏幕
 */
@property (nonatomic, assign) CGFloat drawerExpandHeight;

/// 抽屉视图展开状态定部内边距，默认：20
@property (nonatomic, assign) CGFloat drawerExpandTopInset;

/**
 背景遮罩，默认为一个普通的 UIView，背景色为 blackColor，可设置为自己的 view
 注意：dimmingView 的大小将会盖满整个控件
 JYPulleyViewController 会自动给自定义的 dimmingView 添加手势以实现点击遮罩隐藏浮层
 */
@property (nonatomic, strong) UIView *dimmingView;

/// 背景遮罩点击手势
@property (nonatomic, strong, readonly) UITapGestureRecognizer *dimmingViewTapGestureRecognizer;

/// 背景遮罩显示时的不透明度，默认：0.5
@property (nonatomic, assign) CGFloat dimmingOpacity;

/**
 带有 主内容视图数据源 和 抽屉视图数据源 的初始化

 @param contentDataSource 主内容视图数据源
 @param drawerDataSource 抽屉视图数据源
 @return JYPulleyViewController
 */
- (instancetype)initWithContentDataSource:(id<JYPulleyContentDataSource>)contentDataSource
                         drawerDataSource:(id<JYPulleyDrawerDataSource>)drawerDataSource;

/**
 更新当前状态

 @param status 需要更新的状态
 @param animated 是否需要动画

 @warning 传入的 status 状态必须唯一，不可以位移
 */
- (void)updateStatus:(JYPulleyStatus)status animated:(BOOL)animated;

@end

NS_ASSUME_NONNULL_END