711/Pods/LookinServer/Src/Shared/LookinDisplayItem.h

//
//  LookinDisplayItem.h
//  qmuidemo
//
//  Created by Li Kai on 2018/11/15.
//  Copyright © 2018 QMUI Team. All rights reserved.
//



#import "TargetConditionals.h"
#import "LookinObject.h"
#import "LookinDefines.h"
#if TARGET_OS_IPHONE
#import <UIKit/UIKit.h>
#elif TARGET_OS_MAC
#import <Appkit/Appkit.h>
#endif

@class LookinAttributesGroup, LookinIvarTrace, LookinPreviewItemLayer, LookinEventHandler, LookinDisplayItemNode, LookinDisplayItem;

typedef NS_ENUM(NSUInteger, LookinDisplayItemImageEncodeType) {
    LookinDisplayItemImageEncodeTypeNone,   // 不进行 encode
    LookinDisplayItemImageEncodeTypeNSData, // 转换为 NSData
    LookinDisplayItemImageEncodeTypeImage   // 使用 NSImage / UIImage 自身的 encode 方法
};

typedef NS_ENUM(NSUInteger, LookinDisplayItemProperty) {
    // 当初次设置 delegate 对象时，会立即以该值触发一次 displayItem:propertyDidChange:
    LookinDisplayItemProperty_None,
    LookinDisplayItemProperty_FrameToRoot,
    LookinDisplayItemProperty_DisplayingInHierarchy,
    LookinDisplayItemProperty_InHiddenHierarchy,
    LookinDisplayItemProperty_IsExpandable,
    LookinDisplayItemProperty_IsExpanded,
    LookinDisplayItemProperty_SoloScreenshot,
    LookinDisplayItemProperty_GroupScreenshot,
    LookinDisplayItemProperty_IsSelected,
    LookinDisplayItemProperty_IsHovered,
    LookinDisplayItemProperty_AvoidSyncScreenshot,
    LookinDisplayItemProperty_InNoPreviewHierarchy,
    LookinDisplayItemProperty_IsInSearch,
    LookinDisplayItemProperty_HighlightedSearchString,
};

@protocol LookinDisplayItemDelegate <NSObject>

- (void)displayItem:(LookinDisplayItem *)displayItem propertyDidChange:(LookinDisplayItemProperty)property;

@end

@interface LookinDisplayItem : NSObject <NSSecureCoding, NSCopying>

@property(nonatomic, copy) NSArray<LookinDisplayItem *> *subitems;

@property(nonatomic, assign) BOOL isHidden;

@property(nonatomic, assign) float alpha;

@property(nonatomic, assign) CGRect frame;

@property(nonatomic, assign) CGRect bounds;

/// 不存在 subitems 时，该属性的值为 nil
@property(nonatomic, strong) LookinImage *soloScreenshot;
/// 无论是否存在 subitems，该属性始终存在
@property(nonatomic, strong) LookinImage *groupScreenshot;

@property(nonatomic, strong) LookinObject *viewObject;
@property(nonatomic, strong) LookinObject *layerObject;
@property(nonatomic, strong) LookinObject *hostViewControllerObject;

/// attrGroups 列表
@property(nonatomic, copy) NSArray<LookinAttributesGroup *> *attributesGroupList;

@property(nonatomic, copy) NSArray<LookinEventHandler *> *eventHandlers;

// 如果当前 item 代表 UIWindow 且是 keyWindow，则该属性为 YES
@property(nonatomic, assign) BOOL representedAsKeyWindow;

@property(nonatomic, weak) id<LookinDisplayItemDelegate> previewItemDelegate;
@property(nonatomic, weak) id<LookinDisplayItemDelegate> rowViewDelegate;

/// view 或 layer 的 backgroundColor，利用该属性来提前渲染 node 的背景色，使得用户感觉加载的快一点
/// 注意有一个缺点是，理论上应该像 screenshot 一样拆成 soloBackgroundColor 和 groupBackgroundColor，这里的 backgroundColor 实际上是 soloBackgroundColor，因此某些场景的显示会有瑕疵
@property(nonatomic, strong) LookinColor *backgroundColor;

#pragma mark - No Encode/Decode

/// 父节点
@property(nonatomic, weak) LookinDisplayItem *superItem;

/// 如果存在 viewObject 则返回 viewObject，否则返回 layerObject
- (LookinObject *)displayingObject;

/// 该 item 在左侧 hierarchy 中显示的字符串，现在则返回其 ShortClassName
@property(nonatomic, copy, readonly) NSString *title;
@property(nonatomic, copy, readonly) NSString *subtitle;

/// 在 hierarchy 中的层级，比如顶层的 UIWindow.indentLevel 为 0，UIWindow 的 subitem 的 indentLevel 为 1
- (NSInteger)indentLevel;

/// className 以 “UI”、“CA” 等开头时认为是系统类，该属性将返回 YES
@property(nonatomic, assign, readonly) BOOL representedForSystemClass;

/**
 该项是否被展开
 @note 假如自己没有被折叠，但是 superItem 被折叠了，则自己仍然不会被看到，但是 self.isExpanded 值仍然为 NO
 @note 如果 item 没有 subitems，则该值没有意义
 */
@property(nonatomic, assign) BOOL isExpanded;

/// 如果有 subitems，则该属性返回 YES，否则返回 NO
@property(nonatomic, assign, readonly) BOOL isExpandable;

/**
 是否能在 hierarchy panel 上被看到，假如有任意一层的父级元素的 isExpanded 为 NO，则 displayingInHierarchy 为 NO。如果所有父级元素的 isExpanded 均为 YES，则 displayingInHierarchy 为 YES
 */
@property(nonatomic, assign, readonly) BOOL displayingInHierarchy;

/**
 如果自身或任意一个上层元素的 isHidden 为 YES 或 alpha 为 0，则该属性返回 YES
 */
@property(nonatomic, assign, readonly) BOOL inHiddenHierarchy;

/// 返回 soloScreenshot 或 groupScreenshot
- (LookinImage *)appropriateScreenshot;

@property(nonatomic, assign) LookinDisplayItemImageEncodeType screenshotEncodeType;

/// 如果该属性为 YES 则不会自动同步该 item 的图像（比如该 item 尺寸过大）
@property(nonatomic, assign) BOOL avoidSyncScreenshot;

@property(nonatomic, weak) LookinPreviewItemLayer *previewLayer;

@property(nonatomic, weak) LookinDisplayItemNode *previewNode;

/// 如果该值为 YES，则该 item 及所有子 item 均不会在 preview 中被显示出来，只能在 hierarchy 中选择。默认为 NO
@property(nonatomic, assign) BOOL noPreview;

/// 如果自身或某个上级元素的 noPreview 值为 YES，则该方法返回 YES
@property(nonatomic, assign, readonly) BOOL inNoPreviewHierarchy;

/// 当小于 0 时表示未被设置
@property(nonatomic, assign) NSInteger previewZIndex;

/**
 在当前 hierarchy 的最顶层的 item 的坐标系中，该 item 的 frame 值
 */
@property(nonatomic, assign, readonly) CGRect frameToRoot;

/// 遍历自身和所有上级元素
- (void)enumerateSelfAndAncestors:(void (^)(LookinDisplayItem *item, BOOL *stop))block;

- (void)enumerateAncestors:(void (^)(LookinDisplayItem *item, BOOL *stop))block;

/// 遍历自身后所有下级元素
- (void)enumerateSelfAndChildren:(void (^)(LookinDisplayItem *item))block;

@property(nonatomic, assign) BOOL preferToBeCollapsed;

@property(nonatomic, assign) BOOL isSelected;

@property(nonatomic, assign) BOOL isHovered;

- (BOOL)itemIsKindOfClassWithName:(NSString *)className;
- (BOOL)itemIsKindOfClassesWithNames:(NSSet<NSString *> *)classNames;

/// 根据 subItems 属性将 items 打平为一维数组
+ (NSArray<LookinDisplayItem *> *)flatItemsFromHierarchicalItems:(NSArray<LookinDisplayItem *> *)items;

@property(nonatomic, assign) BOOL hasDeterminedExpansion;

/// 在 string 这个搜索词下，如果该 displayItem 应该被搜索到，则该方法返回 YES。
/// string 字段不能为 nil 或空字符串
- (BOOL)isMatchedWithSearchString:(NSString *)string;

/// 设置当前是否处于搜索状态
@property(nonatomic, assign) BOOL isInSearch;
/// 因为搜索而应该被高亮的字符串
@property(nonatomic, copy) NSString *highlightedSearchString;

@end