Repository Public
1import Foundation23/// Localisation helper. Keys are the English strings; `fr.lproj/Localizable.strings` carries the French text.4/// Using one helper everywhere lets `scripts/check-localization.py` verify that every key is translated.5func L(_ key: String) -> String {6 NSLocalizedString(key, comment: "")7}89/// Localised format string, e.g. `L("Close %d tabs", count)`.10func L(_ key: String, _ args: CVarArg...) -> String {11 String(format: NSLocalizedString(key, comment: ""), locale: Locale.current, arguments: args)12}1314enum JSONFile {15 static func encoder() -> JSONEncoder {16 let e = JSONEncoder()17 e.outputFormatting = [.sortedKeys]18 e.dateEncodingStrategy = .iso860119 return e20 }2122 static func decoder() -> JSONDecoder {23 let d = JSONDecoder()24 d.dateDecodingStrategy = .iso860125 return d26 }2728 /// Atomically writes `value` to `url`, creating intermediate directories.29 static func write<T: Encodable>(_ value: T, to url: URL) throws {30 try FileManager.default.createDirectory(at: url.deletingLastPathComponent(), withIntermediateDirectories: true)31 let data = try encoder().encode(value)32 try data.write(to: url, options: [.atomic])33 }3435 static func read<T: Decodable>(_ type: T.Type, from url: URL) throws -> T {36 try decoder().decode(type, from: Data(contentsOf: url))37 }3839 /// Decodes `type` from `stored` layered over the JSON of `defaults`.40 /// Keys that are missing in an older file keep their default value, so adding a field41 /// to a settings struct never invalidates files written by previous versions.42 static func decodeMerging<T: Codable>(_ type: T.Type, stored: Data, defaults: T) throws -> T {43 let base = try JSONSerialization.jsonObject(with: encoder().encode(defaults))44 let overlay = try JSONSerialization.jsonObject(with: stored)45 let merged = merge(base, overlay)46 return try decoder().decode(type, from: JSONSerialization.data(withJSONObject: merged))47 }4849 private static func merge(_ base: Any, _ overlay: Any) -> Any {50 guard let b = base as? [String: Any], let o = overlay as? [String: Any] else { return overlay }51 var result = b52 for (key, value) in o {53 if let existing = b[key] { result[key] = merge(existing, value) } else { result[key] = value }54 }55 return result56 }57}5859/// A small persisted value: loaded once, saved atomically on every mutation.60/// A file that cannot be decoded is moved aside (`.corrupt-<timestamp>`) instead of being overwritten silently.61final class JSONFileStore<Value: Codable>: @unchecked Sendable {62 let url: URL?63 private let lock = NSLock()64 private var cached: Value65 private(set) var recoveredFromCorruption = false6667 /// `url == nil` keeps the value in memory only (private windows, tests).68 init(url: URL?, defaults: Value) {69 self.url = url70 self.cached = defaults71 guard let url, let data = try? Data(contentsOf: url) else { return }72 if let value = try? JSONFile.decodeMerging(Value.self, stored: data, defaults: defaults) {73 cached = value74 } else if let value = try? JSONFile.decoder().decode(Value.self, from: data) {75 cached = value76 } else {77 recoveredFromCorruption = true78 let stamp = Int(Date().timeIntervalSince1970)79 let aside = url.deletingLastPathComponent().appendingPathComponent(url.lastPathComponent + ".corrupt-\(stamp)")80 try? FileManager.default.moveItem(at: url, to: aside)81 }82 }8384 var value: Value {85 get { lock.lock(); defer { lock.unlock() }; return cached }86 set {87 lock.lock(); cached = newValue; lock.unlock()88 if let url { try? JSONFile.write(newValue, to: url) }89 }90 }9192 func update(_ body: (inout Value) -> Void) {93 var copy = value94 body(©)95 value = copy96 }97}98