Restore menu bar hiding, Layout, and the Ice Bar on macOS 27

[WuColin-1]

Summary

Makes Ice usable on macOS 27 again: hiding, the Menu Bar Layout editor, and the Ice Bar. Only public APIs are used for hiding. Everything new is gated on #available(macOS 27.0, *).

macOS 27 moved every status item into MenuBarAgent. There are no per-item windows any more, and an oversized status item (Ice's 10,000-point divider) is discarded instead of pushing items off screen. That's why current builds show "Loading menu bar items" and hide nothing (#954, #965, #970, #991, #992).

What's in this branch

This builds on the maintainer's macos-26 branch, not main. Against main the diff includes all 77 macos-26 commits, so the macOS 27 work is easiest to review as macos-26...macos-27 (33 commits of our own, plus #980 and #950).

• Add experimental macOS 27 menu bar compatibility #980 (PWB97): accessibility-based item enumeration, and hiding via an Ice-owned spacer that pushes items into the native overflow.
• fix(xpc): make MenuBarItemService work for ad-hoc-signed builds on macOS 26 #950 (pdurlej): lets MenuBarItemService work with ad-hoc-signed builds.
• Our changes:
  • Removed QA logs and probe tools that posted real input or used the private assessment-mode API.
  • Safer native drags:
    • Ice only drags its boundary within 3 s of a user toggle.
    • It waits until no modifier or mouse button is held and nothing was typed in the last 0.5 s.
    • Keyboard input is suppressed while the synthetic Command key is down.
    • MenuBarAgent-hosted items can't be dragged from Layout; those drags crashed MenuBarAgent in Add experimental macOS 27 menu bar compatibility #980's testing.
  • Safety check: if widening a spacer pushes Ice's own button off the bar, Ice withdraws the spacers.
  • Boundary alignment on 27.0 (26A428): hit testing returns MenuBarAgent's unidentified host button. It's now accepted only when its frame matches the boundary's frame.
  • Spacer sizing: based on Ice's position relative to the notch. Concealment changes are coalesced (one per 300 ms), so rapid clicks don't stack overflow animations.
  • Ice Bar on macOS 27:
    • Hidden items stay concealed, and only the bar opens and closes.
    • Clicking an item briefly reveals the hidden items, clicks the item where MenuBarAgent draws it, and conceals them again after its menu closes.
    • The bar opens without the blocking cache refresh, which always hit its 1 s timeout.
    • It's placed under Ice's button and closes on outside clicks through a passive monitor.
    • There's a new background opacity slider.
  • Glyph capture:
    • The menu bar strip was captured at 1x on Retina displays, because CGDisplayPixelsWide returns points; it's now captured at full resolution.
    • Glyphs are extracted from the bar background, trimmed, and centered.
    • MenuBarAgent's overflow button is excluded from items. Items whose frames overlap it or each other are treated as not drawn, since they're in the system overflow; they show their app icon instead of a garbage crop.
  • Troubleshooting: a DebugDumpMacOS27Glyphs default (off unless set) writes captures and frames to the Caches folder.
  • Unrelated fix: restored a smart-rehide delay that Add experimental macOS 27 menu bar compatibility #980 changed without an availability check for macOS 14–26.
  • Docs: MACOS27.md covers the approach, limitations, and how to build an ad-hoc copy.

Testing

On a notched MacBook, macOS 27.0 (26A428), Xcode 27.0, Release build signed ad hoc:

• Hiding and showing with Ice's button, including rapid clicks.
• Layout drags moving items in the real menu bar.
• Opening the Ice Bar and the sharpness of its glyphs.
• The standalone decision tests (NativeMenuBarBoundaryTests, NativeDragVisibilityStateTests, MacOS27DynamicItemStateTests, MenuBarGlyphImageTests) pass.

Not yet tested:

• The last functional commit (system-overflow detection).
• The opacity slider.
• Clicking an item from the Ice Bar after the overflow change.
• Multiple displays and non-notched displays.
• Regressions on macOS 14–26.

Known limitations

• Other apps' status item images aren't available through any API, so Ice Bar glyphs are crops of the menu bar. Items that macOS keeps in its own overflow can't be captured and show their app icon.
• Clicking an Ice Bar item reflows the menu bar once while it's revealed.
• Search, show on hover/click/scroll, auto-rehide, spacing, and app-menu hiding remain disabled on macOS 27.
• Ad-hoc builds must disable hardened runtime (ENABLE_HARDENED_RUNTIME=NO), or library validation rejects the embedded Sparkle framework.

🤖 Generated with Claude Code