Something went wrong. Try again.
An auto tiler for macOS
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205import Foundationimport ParcelConfigimport ParcelCoreimport ParcelIPCimport ParcelPlatformimport Testing
@testable import ParcelEngine
@Suite("Window classification in the engine")@MainActorstruct RulesEngineTests { @Test func floatingAndIgnoredWindowsHaveExplanationsAndIgnoredWindowsCanReturn() async throws { var config = engineConfiguration() config.rules = [RuleConfiguration(titleContains: "hidden", action: .ignore)] let harness = try EngineHarness(configuration: config) try await harness.start() let dialog = ManagedWindow( id: WindowID(rawValue: 1), app: engineApp, facts: WindowFacts(bundleID: engineApp.bundleID, role: "AXWindow", isModal: true)) let ignored = engineWindow(2, title: "hidden") harness.world.appear(dialog) harness.world.appear(ignored) try harness.scheduler.runReady() #expect(harness.engine.snapshot.state.windows[dialog.id]?.isFloating == true) #expect(harness.engine.snapshot.state.windows[ignored.id] == nil) #expect(harness.engine.classifications[dialog.id]?.reason == .dialog) #expect(harness.engine.classifications[ignored.id]?.disposition == .ignore) let handler = EngineIPCHandler(engine: harness.engine) guard case .object(let answer) = try await handler.why(window: ignored.id.rawValue) else { Issue.record("Expected an object") return } #expect(answer["reason"] == .string("Ignoring because your rule matches test.fixture.")) #expect(answer["disposition"] == .string("ignore")) config.rules = [] try harness.engine.applyConfiguration(config) try harness.scheduler.runReady() #expect(harness.engine.snapshot.state.windows[ignored.id]?.isFloating == false) #expect(harness.engine.classifications[ignored.id]?.reason == .standardWindow) harness.world.disappear(ignored.id) try harness.scheduler.runReady() #expect(harness.engine.classifications[ignored.id] == nil) await #expect(throws: IPCError.self) { try await handler.why(window: ignored.id.rawValue) } await harness.engine.stop() }
@Test func systemPlayerKeepsItsNativeFrameAndWhyExplainsTheDefault() async throws { let harness = try EngineHarness() try await harness.start() try harness.add([1]) let player = engineWindow(2, app: AppID(pid: 101, bundleID: "com.apple.PIPAgent")) let frame = Rect(x: 700, y: 420, width: 320, height: 180) harness.world.appear(player, frame: frame) try harness.scheduler.runReady() try harness.finishMotion() #expect(harness.engine.snapshot.state.windows[player.id]?.isFloating == true) #expect(harness.engine.snapshot.state.workspaces[engineWorkspace]?.tree?.windows == [WindowID(rawValue: 1)]) #expect(harness.world.frames[player.id] == frame) guard case .object(let answer) = try await EngineIPCHandler(engine: harness.engine).why(window: 2) else { Issue.record("Expected a window explanation") await harness.engine.stop() return } #expect(answer["disposition"] == .string("float")) #expect(answer["reason"] == .string("Floating because it's picture-in-picture.")) #expect(harness.engine.snapshot.state.frames[player.id] == frame) #expect(!harness.world.allWrites.contains { $0.window == player.id }) await harness.engine.stop() }
@Test func userRuleCanTileDialogAndPlaceNewWindowOnDisplayAtPosition() async throws { var config = engineConfiguration() let display = DisplayID(rawValue: "00000000-0000-0000-0000-00000000000A") config.rules = [ RuleConfiguration( titleContains: "first", action: .tile, display: display.rawValue.lowercased(), position: 0) ] var initial = engineInitialState(twoDisplays: true) let removedScreen = initial.displays.removeValue(forKey: secondEngineDisplay) let screen = try #require(removedScreen) initial.displays[display] = Display(id: display, frame: screen.frame) initial.activeSpaces[secondEngineDisplay] = nil initial.activeSpaces[display] = SpaceID(rawValue: 2) let harness = try EngineHarness(configuration: config, initialState: initial) try await harness.start() let destination = WorkspaceKey(display: display, space: SpaceID(rawValue: 2)) harness.world.appear(engineWindow(1), workspace: destination) harness.world.appear(engineWindow(2), workspace: destination) try harness.scheduler.runReady() let dialog = ManagedWindow( id: WindowID(rawValue: 3), app: engineApp, title: "first", facts: WindowFacts(bundleID: engineApp.bundleID, role: "AXWindow", title: "first", isModal: true)) harness.world.appear(dialog) try harness.scheduler.runReady() let workspace = try #require(harness.engine.snapshot.state.workspaces[destination]) let expected = [WindowID(rawValue: 3), WindowID(rawValue: 1), WindowID(rawValue: 2)] #expect(workspace.order == expected) #expect(workspace.tree?.windows == expected) #expect(harness.engine.snapshot.state.windows[dialog.id]?.isFloating == false) #expect(harness.engine.classifications[dialog.id]?.reason == .rule(index: 0, bundleID: engineApp.bundleID)) await harness.engine.stop() }
@Test func fixedSizeProfileIsExplainedInsteadOfBeingReplacedByGenericPanelReason() async throws { let harness = try EngineHarness() try await harness.start() let size = Size(width: 320, height: 240) let fixed = ManagedWindow( id: WindowID(rawValue: 1), app: engineApp, isFloating: true, facts: WindowFacts( bundleID: engineApp.bundleID, role: "AXWindow", isResizable: true, minimumSize: size, maximumSize: size)) harness.world.appear(fixed) try harness.scheduler.runReady() let answer = try await inspection(harness, window: fixed.id) #expect(answer["reason"] == .string("Floating because it has fixed size bounds.")) #expect(answer["disposition"] == .string("float")) let profile = try profile(answer) #expect(profile.fixedSize == size && profile.minimumSource == .native) #expect(harness.world.writes.isEmpty) await harness.engine.stop() }
@Test func whyRecomputesLearnedAppProfileAfterConfirmationAndResetWithoutFreshAXFacts() async throws { let harness = try EngineHarness() try await harness.start() let native = Size(width: 300, height: 500) let group = NativeTabGroup.windowIDs([WindowID(rawValue: 1), WindowID(rawValue: 2)]) let window = ManagedWindow( id: WindowID(rawValue: 1), app: engineApp, minimumSize: native, facts: WindowFacts( bundleID: engineApp.bundleID, role: "AXWindow", minimumSize: native, hasNativeTabs: true, nativeTabGroup: group)) harness.world.appear(window) try harness.scheduler.runReady() let initial = try profile(await inspection(harness, window: window.id)) #expect(initial.minimumSource == .native && initial.learnedMinimumSize == nil) let learned = LearnedMinimumSize(size: Size(width: 650, height: 200)) try harness.engine.minimumLearning.recordConfirmed(learned, for: engineApp.bundleID) let answer = try await inspection(harness, window: window.id) let updated = try profile(answer) #expect(updated.minimumSource == .nativeAndLearned) #expect(updated.nativeMinimumSize == native && updated.learnedMinimumSize == learned) #expect(updated.minimumSize == Size(width: 650, height: 500)) #expect(updated.tabsAsWindows == true && updated.nativeTabGroup == group) #expect(answer["reason"] == .string("Tiling because native tabs share one tile.")) try await harness.engine.resetLearnedMinimums(for: engineApp.bundleID) try harness.scheduler.runReady() let reset = try profile(await inspection(harness, window: window.id)) #expect(reset.minimumSource == .native && reset.minimumSize == native) #expect(reset.learnedMinimumSize == nil) await harness.engine.stop() }
private func inspection(_ harness: EngineHarness, window: WindowID) async throws -> [String: JSONValue] { let response = try await EngineIPCHandler(engine: harness.engine).why(window: window.rawValue) guard case .object(let answer) = response else { throw InspectionFailure.expectedObject } return answer }
private func profile(_ answer: [String: JSONValue]) throws -> AppTilingProfile { let value = try #require(answer["app_profile"]) return try JSONDecoder().decode(AppTilingProfile.self, from: JSONEncoder().encode(value)) }
private enum InspectionFailure: Error { case expectedObject }
@Test func confirmedMinimumSurvivesRefreshRestartAndPerAppReset() async throws { let directory = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString) defer { try? FileManager.default.removeItem(at: directory) } let store = MinimumSizeStore(fileURL: directory.appendingPathComponent("minimum.json")) let harness = try EngineHarness(minimumSizeStore: store) harness.world.behaviors[engineApp] = FakeEngineWorld.Behavior(minimumSize: Size(width: 700, height: 200)) try await harness.start() try harness.add([1, 2]) #expect(harness.world.writes.count == 1) #expect(harness.log.diagnostics.filter { if case .frameAdjusted = $0 { true } else { false } }.count == 2) #expect(try store.load().learned.isEmpty) try harness.scheduler.advance(by: 0.1) harness.engine.send(.commandIssued(.retile)) try harness.scheduler.runReady() #expect(harness.world.writes.count == 2) let expected = LearnedMinimumSize(size: Size(width: 700, height: 0)) #expect(harness.engine.learnedMinimums[engineApp.bundleID] == expected) harness.world.appear(engineWindow(1, title: "changed")) try harness.scheduler.runReady() #expect(harness.engine.snapshot.state.windows[WindowID(rawValue: 1)]?.minimum == expected) await harness.engine.stop() #expect(try store.load().learned[engineApp.bundleID] == expected)
let restarted = try EngineHarness(minimumSizeStore: store) try await restarted.start() try restarted.add([3]) #expect(restarted.engine.snapshot.state.windows[WindowID(rawValue: 3)]?.minimum == expected) try await restarted.engine.resetLearnedMinimums(for: engineApp.bundleID) try restarted.scheduler.runReady() #expect(restarted.engine.snapshot.state.windows[WindowID(rawValue: 3)]?.minimum == nil) #expect(try store.load().learned.isEmpty) await restarted.engine.stop() }}