dependencies: [
    .package(url: "https://github.com/itruf/PartialJSON.git", from: "0.0.2")
]

targets: [
    .target(
        name: "YourTarget",
        dependencies: ["PartialJSON"]
    )
]

import PartialJSON

// Parse incomplete JSON with default options
let incompleteJSON = "[1, 2, 3"
let result = try PartialJSON.parse(incompleteJSON)
// Result: [1, 2, 3]

// Parse incomplete object
let partialObject = "{\"name\": \"John\", \"age\""
let obj = try PartialJSON.parse(partialObject)
// Result: ["name": "John"]

// Allow all types to be partial
let result = try PartialJSON.parse("[1, 2, 3.", options: .all)
// Result: [1, 2, 3.0]

// Allow only arrays and objects to be partial
let result = try PartialJSON.parse("[1, 2, 3", options: .collections)
// Result: [1, 2, 3]

// Custom options combination
let customOptions: PartialJSONOptions = [.array, .object, .string]
let result = try PartialJSON.parse("{\"text\": \"incompl", options: customOptions)
// Result: ["text": "incompl"]

// Individual options
.string           // Allow partial strings
.number           // Allow partial numbers
.array            // Allow partial arrays
.object           // Allow partial objects
.null             // Allow partial null (e.g., "nu" → null)
.boolean          // Allow partial booleans (e.g., "tr" → true)
.nan              // Allow partial NaN
.infinity         // Allow partial Infinity
.negativeInfinity // Allow partial -Infinity

// Convenience combinations
.allInfinity      // Both positive and negative infinity
.special          // null, boolean, infinity, nan
.atomic           // string, number, special
.collections      // array, object
.all              // Everything
.allExceptNumbers // Everything except numbers (default)

do {
    let result = try PartialJSON.parse(jsonString)
} catch let error as PartialJSONError {
    // JSON is incomplete in a way not allowed by options
    print("Incomplete JSON: \(error.message) at position \(error.position)")
} catch let error as MalformedJSONError {
    // JSON has invalid syntax
    print("Invalid JSON: \(error.message) at position \(error.position)")
}

class StreamingParser {
    private var buffer = ""
    private let options: PartialJSONOptions = .all
    
    func append(_ chunk: String) -> Any? {
        buffer += chunk
        
        do {
            return try PartialJSON.parse(buffer, options: options)
        } catch {
            // Not yet complete, wait for more data
            return nil
        }
    }
}

// Useful for showing partial results while loading
func loadProgressively(from chunks: [String]) {
    var accumulated = ""
    
    for chunk in chunks {
        accumulated += chunk
        
        if let partial = try? PartialJSON.parse(accumulated, options: .collections) {
            // Update UI with partial results
            updateDisplay(with: partial)
        }
    }
}

// Handle potentially truncated API responses
func handleAPIResponse(_ data: Data) throws -> Any {
    guard let jsonString = String(data: data, encoding: .utf8) else {
        throw APIError.invalidEncoding
    }
    
    // Try to parse even if response was truncated
    return try PartialJSON.parse(jsonString, options: .allExceptNumbers)
}