@shijing/taoyao

// 1. 强类型权限定义 (替代字符串)
enum SystemPermission {
    case Camera
    case Microphone
    case Location
    case ContactRead
    case FileWrite
    // ... 所有系统权限
}

// 权限状态 (代数数据类型)
enum PermissionState {
    case Granted
    case Denied(CanRequestAgain: Bool) // 是否可再次请求
    case ForeverDenied // 需引导去设置页
    case NotDetermined
}

// 2. 强类型选择器配置
struct ContactPickerConfig {
    let maxSelectCount: Int32 = 1
    let allowedFields: List<ContactField> // 编译期指定所需字段，减少数据拷贝
}

struct MediaPickerConfig {
    let mediaType: MediaType // Enum: Image, Video, Audio
    let maxSelectCount: Int32
    let sourceType: SourceType // Enum: Gallery, Camera
}

// 3. 核心框架类
class TaoYao {
    private var context: AbilityContext // 通过 Trait 抽象
    
    init(context: AbilityContext) {
        self.context = context
    }
    
    // 权限检查 (编译期类型安全)
    async func checkPermission(perm: SystemPermission): Result<PermissionState, String> {
        // 调用原生 API，返回强类型状态
        // ...
    }
    
    // 链式权限请求
    async func requestPermissions(perms: List<SystemPermission>): Result<List<PermissionState>, String> {
        // 内部状态机管理
        // ...
    }
    
    // 强类型联系人选择器
    async func pickContacts(config: ContactPickerConfig): Result<List<ContactInfo>, String> {
        // 直接传递 struct 给 Native，零拷贝
        // ...
    }
    
    // 强类型媒体选择器
    async func pickMedia(config: MediaPickerConfig): Result<List<MediaAsset>, String> {
        // ...
    }
}

// 4. 业务场景示例：发布带图动态
class PostService {
    private var taoyao: TaoYao
    
    init(taoyao: TaoYao) { self.taoyao = taoyao }
    
    async func createPostWithImage(): Unit {
        // 1. 编译期确保权限类型正确
        let perms = [SystemPermission.Camera, SystemPermission.Microphone]
        
        // 2. 异步请求权限，线性流程
        let states = try await this.taoyao.requestPermissions(perms)
        
        // 3. 模式匹配处理所有状态分支 (编译器强制检查)
        for i in 0..<states.size() {
            match (states[i]) {
                case .Granted => { /* 继续 */ }
                case .Denied(canRequest: true) => { 
                    print("Permission denied, retrying...") 
                    // 重试逻辑
                }
                case .ForeverDenied => { 
                    print("Please enable in settings") 
                    this.openSettings()
                    return 
                }
                case .NotDetermined => { /* 不应出现 */ }
            }
        }
        
        // 4. 调用选择器，配置编译期校验
        let config = MediaPickerConfig(mediaType: .Image, maxSelectCount: 9, sourceType: .Gallery)
        let images = try await this.taoyao.pickMedia(config)
        
        // 5. 业务处理
        this.uploadImages(images)
    }
}

# PR 自动化流水线
cjpm fmt --check
cjpm build --release
cjpm lint --deny-warnings
cjpm test --coverage --min-coverage 90
# 类型严格性检查 (确保没有 Any 滥用)
cjpm analyze --strict-types