feat: open-source 小浣熊阅读 for iOS

2026-10-24 21:01:22 +08:00 · 2026-10-14 11:37:36 +08:00
commit ffc9e9d91d
193 changed files with 41382 additions and 0 deletions
@@ -0,0 +1,103 @@
+import Foundation
+
+public struct RuleDiagnostic: Codable, Hashable, Identifiable, Sendable {
+    public enum Severity: String, Codable, Sendable {
+        case warning
+        case error
+    }
+
+    public var severity: Severity
+    public var code: String
+    public var message: String
+    public var rule: String
+
+    public var id: String { "\(severity.rawValue):\(code):\(rule):\(message)" }
+
+    public init(severity: Severity, code: String, message: String, rule: String) {
+        self.severity = severity
+        self.code = code
+        self.message = message
+        self.rule = rule
+    }
+}
+
+public enum RuleEngineError: Error, Equatable, LocalizedError, Sendable {
+    case malformedRule(rule: String, detail: String)
+    case unsupportedRule(rule: String, feature: String)
+    case invalidInput(rule: String, expected: String)
+    case resourceLimit(rule: String, detail: String)
+
+    public var code: String {
+        switch self {
+        case .malformedRule: "rule.malformed"
+        case .unsupportedRule: "rule.unsupported"
+        case .invalidInput: "rule.invalid_input"
+        case .resourceLimit: "rule.resource_limit"
+        }
+    }
+
+    public var errorDescription: String? {
+        switch self {
+        case .malformedRule(_, let detail),
+             .invalidInput(_, let detail),
+             .resourceLimit(_, let detail):
+            detail
+        case .unsupportedRule(_, let feature):
+            "当前规则后端尚不支持：\(feature)"
+        }
+    }
+
+    public var rule: String {
+        switch self {
+        case .malformedRule(let rule, _),
+             .unsupportedRule(let rule, _),
+             .invalidInput(let rule, _),
+             .resourceLimit(let rule, _):
+            rule
+        }
+    }
+
+    public var diagnostic: RuleDiagnostic {
+        .init(severity: .error, code: code, message: localizedDescription, rule: rule)
+    }
+}
+
+public struct RuleEvaluation: Sendable {
+    public var values: [JSONValue]
+    public var diagnostics: [RuleDiagnostic]
+    public var variables: [String: String]
+
+    public init(
+        values: [JSONValue] = [],
+        diagnostics: [RuleDiagnostic] = [],
+        variables: [String: String] = [:]
+    ) {
+        self.values = values
+        self.diagnostics = diagnostics
+        self.variables = variables
+    }
+
+    public var strings: [String] {
+        values.flatMap { value in
+            if case .array(let items) = value { return items.map(\.stringValue) }
+            return [value.stringValue]
+        }
+    }
+
+    func listItems(rule: String) -> [JSONValue] {
+        if rule.trimmingCharacters(in: .whitespacesAndNewlines).hasPrefix(":") { return values }
+        return values.flatMap { value in
+            if case .array(let items) = value { return items }
+            return [value]
+        }
+    }
+    public var firstString: String? { strings.first(where: { !$0.isEmpty }) }
+    public var leadingString: String? {
+        guard let value = strings.first, !value.isEmpty else { return nil }
+        return value
+    }
+    public var joinedString: String? {
+        let value = strings.joined(separator: "\n")
+        return value.isEmpty ? nil : value
+    }
+}