An auto tiler for macOS
38 files

GuidedTour.swift
LearningGeometry.swift
LearningPanel.swift
README.md
TourAllowView.swift
TourBackButton.swift
TourCheckOperation.swift
TourContentMeasurements.swift
TourDemoCanvas.swift
TourDemoKind.swift
TourDemoLoopPlayback.swift
TourDemoMiniature.swift
TourDemoMotion.swift
TourDemoPlayback.swift
TourDemoPlayer.swift
TourDemoPresenceView.swift
TourDemoPresentation.swift
TourDemoScene.swift
TourDemoStep.swift
TourDemoText.swift
TourDemoWelcome.swift
TourDemoWindow.swift
TourDemoWindowPresence.swift
TourDemoWindowView.swift
TourNavigationPreferenceError.swift
TourNavigationShortcuts.swift
TourPresentation.swift
TourSetup.swift
TourSetupProgress.swift
TourSetupView.swift
TourShortcutWarningPresentation.swift
TourStartResult.swift
TourStepTabs.swift
TourView.swift
TourWelcomeView.swift
TourWindowChrome.swift
TourWindowGeometry.swift
WindowLearningController.swift
README.md

Guided tour #

Welcome → Allow Parcel → Ready, for both Auto Mode and Manual Mode. Welcome offers Auto Mode as the primary action and a smaller, borderless Manual Mode option; either saves the intent and opens Allow. The native full-size window keeps its traffic lights without an inner frame. Its width stays at 560 points; height fits each step, including expanded references, errors, and replay disclosure. The top edge stays fixed while the existing window motion token animates the height; Reduce Motion and motion off resize instantly. The footer follows content with consistent padding, not an empty spacer. No step scrolls or shrinks its text. Welcome's 280 × 175-point fictional demo plays while active and becomes a static tiled frame with Reduce Motion or motion off.

First run and replay hold every product write before discovery or queued motion. Grant changes, navigation, Settings links, and config reloads never release that hold. Closing or Set up later saves the draft and leaves Automatic tiling off. Incomplete or interrupted setup reopens at launch. Continue Setup in the menu focuses the tour; Automatic tiling opens it while setup is pending. Uncertain recovery offers Keep current arrangement, then returns to setup with movement held until the user explicitly finishes setup or chooses Tidy my workspace. Completed, deferred replays without recovery stay closed. After writers drain, the tour retires earlier shutdown-placement debt so deferring and quitting cannot replay pre-tour frames. This is bookkeeping, not a native capture. Completed v2 users are not forced through v3.

The circular Back button uses Command-left bracket. The window-local preference guidedTour.navigation.back accepts the configured chord grammar or none to remove the shortcut; an absent value uses the defaults table. Changes take effect at the next launch. Invalid values fail visibly rather than restoring defaults.

Allow combines Accessibility status and purpose in one message, without auto-advancing. Filled green checks mean on; empty circles mean still to do. Open at login is optional, recommended, and defaults on only for a fresh install. Its staged change is attempted once on Continue; failure is optional and never blocks Ready or retries from Tidy. Checks and login changes have a three-second deadline. Unknown access stays inert; a late native acknowledgement cannot navigate or authorize another attempt.

Automatic's final action drains writers, captures fresh native frames, and tidies only the tour's display/native Space using current settings. A versioned checkpoint precedes writes; durable completion precedes global automatic release. Unknown readback is failure, not partial success. Cancellation waits for writer termination and verified scoped recovery. Successful completion closes immediately; partial and recovery results remain visible with local Details. A safe partial result needs acknowledged, independently observed frames and bounded non-overlap; missing startup discovery fails before writing. Existing phase logs retain capture, commitment, skipped-app evidence, and recovery.

Manual's Finish setup saves completion and Automatic tiling off, without Tidy or flushing held work. Its optional reference shows only usable effective shortcuts; editing opens the same Settings pane as Keyboard Shortcuts. Separate practice state, shared geometry, motion, and shortcut speech remain unchanged.

Unit tests cover navigation, permissions, login, effective bindings, saved progress, replay, cancellation, and transaction outcomes. Locked fixture/reality lanes provide independent native-frame evidence; hosted renders do not prove spoken VoiceOver or native input. Translations ship in eight languages and still need editorial review.