Something went wrong. Try again.
An auto tiler for macOS
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195import os
public enum ParcelTraceCategory: String, CaseIterable, Sendable { case engine = "Engine" case input = "Input" case motion = "Motion" case overlay = "Overlay" case platform = "Platform" case config = "Config" case pointsOfInterest = "PointsOfInterest"}
public enum ParcelTraceName: CaseIterable, Sendable { case eventToFirstWrite, eventToSettled, detect, apply, layout, diff, reduce, plan, publish case tapCallback, hotkeyDispatch, inputLatency case tick, sample, write, settle, snap case overlayUpdate, ghostRender case windowListRead, spaceRead, displayReconfigure case reload
public var category: ParcelTraceCategory { switch self { case .eventToSettled: .pointsOfInterest case .eventToFirstWrite, .detect, .apply, .layout, .diff, .reduce, .plan, .publish: .engine case .tapCallback, .hotkeyDispatch, .inputLatency: .input case .tick, .sample, .write, .settle, .snap: .motion case .overlayUpdate, .ghostRender: .overlay case .windowListRead, .spaceRead, .displayReconfigure: .platform case .reload: .config } }
public var name: StaticString { switch self { case .eventToFirstWrite: "Event to first write" case .eventToSettled: "Event to settled" case .detect: "Detect" case .apply: "Apply" case .layout: "Layout" case .diff: "Diff" case .reduce: "Reduce" case .plan: "Plan" case .publish: "Publish" case .tapCallback: "Tap callback" case .hotkeyDispatch: "Hotkey dispatch" case .inputLatency: "Input latency" case .tick: "Tick" case .sample: "Sample" case .write: "Write" case .settle: "Motion settle" case .snap: "Snap" case .overlayUpdate: "Overlay update" case .ghostRender: "Ghost render" case .windowListRead: "Window list read" case .spaceRead: "Space read" case .displayReconfigure: "Display reconfigure" case .reload: "Reload" } }}
public struct ParcelTraceInterval: Sendable { public let identifier: UInt64 fileprivate let state: OSSignpostIntervalState?
public init(identifier: UInt64) { self.identifier = identifier state = nil }
fileprivate init(identifier: UInt64, state: OSSignpostIntervalState) { self.identifier = identifier self.state = state }}
@MainActorpublic protocol ParcelTraceSink: AnyObject { func emits(_ name: ParcelTraceName) -> Bool func beginInterval(_ name: ParcelTraceName, value: UInt64, detail: UInt64) -> ParcelTraceInterval func endInterval(_ name: ParcelTraceName, _ interval: ParcelTraceInterval, value: UInt64, detail: UInt64) func event(_ name: ParcelTraceName, value: UInt64, detail: UInt64)}
extension ParcelTraceSink { public func beginIfEnabled(_ name: ParcelTraceName, value: UInt64 = 0, detail: UInt64 = 0) -> ParcelTraceInterval? { guard emits(name) else { return nil } return beginInterval(name, value: value, detail: detail) }
public func endIfStarted( _ name: ParcelTraceName, _ interval: ParcelTraceInterval?, value: UInt64 = 0, detail: UInt64 = 0 ) { guard let interval else { return } endInterval(name, interval, value: value, detail: detail) }}
@MainActorpublic final class SignpostTraceSink: ParcelTraceSink { public static let shared = SignpostTraceSink() public init() {} public func emits(_ name: ParcelTraceName) -> Bool { ParcelSignposts.isEnabled(name) } public func beginInterval(_ name: ParcelTraceName, value: UInt64, detail: UInt64) -> ParcelTraceInterval { ParcelSignposts.begin(name, value: value, detail: detail) } public func endInterval(_ name: ParcelTraceName, _ interval: ParcelTraceInterval, value: UInt64, detail: UInt64) { ParcelSignposts.endIfStarted(name, interval, value: value, detail: detail) } public func event(_ name: ParcelTraceName, value: UInt64, detail: UInt64) { ParcelSignposts.event(name, value: value, detail: detail) }}
public enum ParcelSignposts { private struct Lane: Sendable { let log: OSLog let signposter: OSSignposter init(_ category: ParcelTraceCategory) { log = OSLog(subsystem: "com.parcel", category: category.rawValue) signposter = OSSignposter(logHandle: log) } }
private static let engine = Lane(.engine) private static let input = Lane(.input) private static let motion = Lane(.motion) private static let overlay = Lane(.overlay) private static let platform = Lane(.platform) private static let config = Lane(.config) private static let pointsOfInterest = Lane(.pointsOfInterest)
private static func lane(_ category: ParcelTraceCategory) -> Lane { switch category { case .engine: engine case .input: input case .motion: motion case .overlay: overlay case .platform: platform case .config: config case .pointsOfInterest: pointsOfInterest } }
public static func isEnabled(_ name: ParcelTraceName) -> Bool { lane(name.category).signposter.isEnabled }
public static func beginIfEnabled( _ name: ParcelTraceName, value: UInt64 = 0, detail: UInt64 = 0 ) -> ParcelTraceInterval? { guard isEnabled(name) else { return nil } return begin(name, value: value, detail: detail) }
fileprivate static func begin(_ name: ParcelTraceName, value: UInt64, detail: UInt64) -> ParcelTraceInterval { let signposter = lane(name.category).signposter let id = signposter.makeSignpostID() let state = signposter.beginInterval( name.name, id: id, "value=\(value, privacy: .public) detail=\(detail, privacy: .public)") return ParcelTraceInterval(identifier: id.rawValue, state: state) }
public static func endIfStarted( _ name: ParcelTraceName, _ interval: ParcelTraceInterval?, value: UInt64 = 0, detail: UInt64 = 0 ) { guard let interval else { return } guard let state = interval.state else { preconditionFailure("A native interval must have a native begin") } lane(name.category).signposter.endInterval( name.name, state, "value=\(value, privacy: .public) detail=\(detail, privacy: .public)") }
public static func event(_ name: ParcelTraceName, value: UInt64 = 0, detail: UInt64 = 0) { let signposter = lane(name.category).signposter guard signposter.isEnabled else { return } signposter.emitEvent(name.name, "value=\(value, privacy: .public) detail=\(detail, privacy: .public)") }
public static func displayRefresh(interval: Double) { let signposter = motion.signposter guard signposter.isEnabled else { return } signposter.emitEvent("Display refresh", "interval=\(interval, privacy: .public)") }
public static func beginTransaction(_ name: ParcelTraceName, identifier: UInt64) { let lane = lane(name.category) guard lane.signposter.isEnabled else { return } os_signpost(.begin, log: lane.log, name: name.name, signpostID: OSSignpostID(identifier)) }
public static func endTransaction(_ name: ParcelTraceName, identifier: UInt64) { let lane = lane(name.category) guard lane.signposter.isEnabled else { return } os_signpost(.end, log: lane.log, name: name.name, signpostID: OSSignpostID(identifier)) }}