//
//  KBStreamTextView.h
//  KeyBoard
//
//  一个可滚动的视图，用于接收“流式”文本输入。
//  当检测到分隔符（默认: "\t" 制表符）时，会将当前累计的文本作为一个段落
//  创建一个新的 UILabel；每个标签支持自动换行和点击事件。
//  适用于流式数据逐步到达、按段落追加展示的场景。
//

#import <UIKit/UIKit.h>

NS_ASSUME_NONNULL_BEGIN

typedef void (^KBStreamTextTapHandler)(NSInteger index, NSString *text);

@interface KBStreamTextView : UIView

/// 分段分隔符，默认 "\t"（制表符）。
@property (nonatomic, copy) NSString *delimiter;

/// 标签使用的字体，默认系统 16 号。
@property (nonatomic, strong) UIFont *labelFont;

/// 标签文本颜色，iOS 13+ 默认 labelColor，低版本默认黑色。
@property (nonatomic, strong) UIColor *labelTextColor;

/// 水平内边距（左右留白），默认 12。
@property (nonatomic, assign) CGFloat contentHorizontalPadding;

/// 标签间的垂直间距，默认 5。
@property (nonatomic, assign) CGFloat interItemSpacing;

/// 标签点击回调，提供被点击的序号与文本。
@property (nonatomic, copy, nullable) KBStreamTextTapHandler onLabelTap;

/// 是否裁剪各段落前后的空白/换行，默认 YES。
@property (nonatomic, assign) BOOL shouldTrimSegments;

/// 追加流式文本（边输边见）：
/// - 实时将未完成段落展示在“当前标签”上；
/// - 当遇到分隔符时，先将当前标签视为“完成段”，可选裁剪空白，再创建一个新的空标签作为下一段的容器。
- (void)appendStreamText:(NSString *)text;

/// 清空所有标签并重置内部缓冲。
- (void)reset;

/// 结束输入：将当前正在输入的段落视为完成段（按需裁剪），但不会再新建标签。
- (void)finishStreaming;

@end

NS_ASSUME_NONNULL_END