class MySheetViewController: UIViewController {

    override func shortFormHeight() -> PanModalHeight {
        PanModalHeight(type: .content, height: 300)
    }

    override func longFormHeight() -> PanModalHeight {
        PanModalHeight(type: .max, height: 0)  // 全屏
    }

    override func originPresentationState() -> PresentationState {
        .short  // 首次弹出为半屏
    }
}

// 展示弹窗 — 任何 UIViewController 都可以调用
presentPanModal(MySheetViewController())

let contentView = TFYSwiftPanModalContentView(frame: .zero)
contentView.backgroundColor = .systemBackground
// ... 添加自定义子视图 ...

// 直接在 window 上展示
contentView.present(in: view.window)

// 关闭
contentView.dismiss(animated: true, completion: nil)

let popup = TFYSwiftPopupView(frame: .zero)
popup.backgroundColor = .systemBackground
popup.layer.cornerRadius = 16
// ... 添加自定义子视图 ...

// 选择动画器（12 种可选）
let animator = TFYSwiftPopupSpringAnimator()
let center = TFYSwiftPopupAnimatorLayoutCenter.layout(
    offsetY: 0, offsetX: 0, width: 300, height: 220
)
animator.layout = TFYSwiftPopupAnimatorLayout.center(center)

// 展示
popup.show(in: window, animator: animator)

// 关闭
popup.dismissAnimated(true)

let popup = TFYSwiftPopupView(frame: .zero)
popup.backgroundColor = .systemBackground

// 从底部滑入，全宽，高度 250
let bottom = TFYSwiftPopupAnimatorLayoutBottom.layout(
    bottomMargin: 0, offsetX: 0, height: 250
)
let animator = TFYSwiftPopupSlideAnimator(
    direction: .fromBottom,
    layout: TFYSwiftPopupAnimatorLayout.bottom(bottom)
)

popup.show(in: window, animator: animator)

let config = TFYSwiftPopupBottomSheetConfiguration()
config.defaultHeight = 350
config.enableGestures = true        // 开启拖拽手势
config.cornerRadius = 16
config.allowsFullScreen = true      // 允许上拉全屏

let animator = TFYSwiftPopupBottomSheetAnimator(configuration: config)
let popup = TFYSwiftPopupView(frame: .zero)
// ... 添加内容 ...

popup.show(in: window, animator: animator)

class AdvancedSheetVC: UIViewController {

    // MARK: - 高度
    override func shortFormHeight() -> PanModalHeight {
        PanModalHeight(type: .content, height: 300)
    }
    override func mediumFormHeight() -> PanModalHeight {
        PanModalHeight(type: .content, height: 500)
    }
    override func longFormHeight() -> PanModalHeight {
        PanModalHeight(type: .max, height: 0)
    }

    // MARK: - ScrollView 联动
    override func panScrollable() -> UIScrollView? { tableView }

    // MARK: - 背景
    override func backgroundConfig() -> TFYSwiftBackgroundConfig {
        let config = TFYSwiftBackgroundConfig.config(behavior: .customBlurEffect)
        config.backgroundAlpha = 0.6
        config.backgroundBlurRadius = 15
        return config
    }

    // MARK: - 外观
    override func cornerRadius() -> CGFloat { 20 }
    override func contentShadow() -> TFYSwiftPanModalShadow {
        TFYSwiftPanModalShadow(
            color: .black.withAlphaComponent(0.3),
            radius: 12,
            offset: CGSize(width: 0, height: -4),
            opacity: 0.4
        )
    }

    // MARK: - 交互
    override func allowsDragToDismiss() -> Bool { true }
    override func allowsTapBackgroundToDismiss() -> Bool { true }
    override func springDamping() -> CGFloat { 0.8 }
}

// 居中
TFYSwiftPopupAnimatorLayout.center(
    TFYSwiftPopupAnimatorLayoutCenter.layout(offsetY: 0, offsetX: 0, width: 300, height: 200)
)

// 顶部
TFYSwiftPopupAnimatorLayout.top(
    TFYSwiftPopupAnimatorLayoutTop.layout(topMargin: 0, offsetX: 0, height: 250)
)

// 底部
TFYSwiftPopupAnimatorLayout.bottom(
    TFYSwiftPopupAnimatorLayoutBottom.layout(bottomMargin: 0, offsetX: 0, height: 250)
)

// 左侧
TFYSwiftPopupAnimatorLayout.leading(
    TFYSwiftPopupAnimatorLayoutLeading.layout(leadingMargin: 0, offsetY: 0, width: 280)
)

// 右侧
TFYSwiftPopupAnimatorLayout.trailing(
    TFYSwiftPopupAnimatorLayoutTrailing.layout(trailingMargin: 0, offsetY: 0, width: 280)
)

// 自定义 Frame
TFYSwiftPopupAnimatorLayout.frame(CGRect(x: 50, y: 100, width: 300, height: 200))

class MyPopupDelegate: TFYSwiftPopupViewDelegate {
    func popupViewWillAppear(_ popupView: TFYSwiftPopupView) { }
    func popupViewDidAppear(_ popupView: TFYSwiftPopupView) { }
    func popupViewWillDisappear(_ popupView: TFYSwiftPopupView) { }
    func popupViewDidDisappear(_ popupView: TFYSwiftPopupView) { }
    func popupViewShouldDismiss(_ popupView: TFYSwiftPopupView) -> Bool { true }
    func popupViewDidTapBackground(_ popupView: TFYSwiftPopupView) { }
}