Breaking Changes

• Update Sauce.framework v2.4.0 ( #89 )
• Update minimum deployment target to macOS 10.13 ( #89 )

Enhancements

• Support Xcode15 ( #89 )

Breaking Changes

• Update Sauce.framework v2.2.0. ( #74 )
  • See v2.2.0 release page for more information.

Enhancements

• Initialize NSEvent.ModifierFlags from carbon modifiers. ( #63 )
• Add public extension NSEvent.keyCombo. ( #67 )
• Replace deprecated converter calls. ( #71 )

Bugfixes

• Fix dependencies target version. ( #76 )

Thanks @DivineDominion for contributing!

Breaking Changes

• None.

v3.x Migration Guide

Enhancements

• Update Sauce.framework v2.1.0. ( #57 )
• Change the save to KeyCode or Key to support special keys. ( #59 )

Bugfixes

• Change ModifierEventHandler access control. ( #55 )
• Fix so that modifiers are not reflected in non-alphabetic keys. ( #58 )

Breaking Changes

• None.

v3.x Migration Guide

Enhancements

• Publicated of Key and fix the decoding ( #51 )
• Separated modifier event handling ( #52 )
• Added more tests.

Bugfixes

• None.

Enhancements

• Added keyEquivalent property to KeyCombo. ( #50 )
  • KeyCombo.characters returns the string that is entered when the modifier is actually pressed. (e.g.: ⌘V → v, ⇧V → V, ⌥V → √ )
  • KeyCombo.keyEquivalent returns a string which takes into account only the Shift key. (e.g.: ⌘V → v, ⇧V → V, ⌥V → v, ⌥⇧V → V)

To make keyEquivalent case-sensitive, use keyEquivalent.uppercased() if you want to use it in uppercase.

Bugfixes

• Renamed convertSupportCococaModifiers to convertSupportCocoaModifiers. ( #50 )

Enhancements

• Added keyEquivalentModifierMask, keyEquivalentModifierMaskString properties to KeyCombo for NSMenuItem. ( #48 )

Bugfixes

• None.

Enhancements

• None.

Bugfixes

• Fix dependency framework settings.

Enhancements

• Change Int extension access control. ( #46 )

Bugfixes

• None.

Breaking Changes

• Added Sauce.framework to dependency library. ( #42 )
• Added KeyCombo(key:carbonModifiers:) KeyCombo(key:cocoaModifiers:). ( #44 )
• Renamed KeyCombo(keyCode:carbonModifiers:) KeyCombo(keyCode:cocoaModifiers:) to KeyCombo(QWERTYKeyCode:carbonModifiers:) KeyCombo(QWERTYKeyCode:cocoaModifiers:). ( #44 )
• Renamed KeyCombo.keyCode to KeyCombo.QWERTYKeyCode. ( #44 )
• Removed KeyTransformer.swift ( #44 )
• KeyCombo.characters now returns a string with a modifier. (e.g.: ⌘V → v, ⇧V → V, ⌥V → √ )
• Drop support macOS 10.9 Mavericks.

v3.x Migration Guide

Enhancements

• Supported for keyboard layouts other than the QWERTY keyboard. ( #44 )
• Supported Key enum case initializer. ( #44 ) ( #16 )

Bugfixes

• Fixed a problem where characters could not be generated with modifiers correctly. ( #44 ) ( #10 )
• Fixed double-tap shortcuts being disabled if accessibility is not enabled since macOS 10.14 Mojave. ( #45 )

Enhancements

• HotKey inherits NSObject. ( #9 )

Bugfixes

• None.