feat: implements mouse control support for MacOS

[Kircheneer]

Describe your changes. Use imperative present tense.

Implemented mouse control support for MacOS.

Checklist

• Add documentation to docs/config.adoc
  • N/A - already in
  • Updated known issues for platforms
• Add example and basic docs to cfg_samples/kanata.kbd
  • N/A - already in
• Update error messages
  • Yes
• Added tests, or did manual testing
  • Yes

[nightscape]

I just tried this, great job!
Mouse movement and mrgt work without issues, but mlft does not click.
@Kircheneer same for you?

[Kircheneer]

I plan to address @nightscape's comments, just haven't had a lot of time to check yet.

[Kircheneer]

I have tried with the following config:

(defsrc
e
)

(defalias
e mlft
)

(deflayer default
@e
)

and this worked flawlessly. Can you share what config you are on maybe?

[nightscape]

@Kircheneer I just tried again with your configuration and I'm still observing the same behaviour:
I can click on certain things, e.g. the Mac OS Menu Bar, but not others, e.g. to change a tab in iTerm.
Do you have iTerm installed? If so, could you try switching tabs using the mlft?

[jtroo]

I think this PR is OK to merge as-is, but please do file a bug with investigation notes

[molnarg]

This is awesome, thanks for implementing it. I have come across problem though, when testing it. Somehow the left mouse action trigger a weird click that doesn't work in all apps on all buttons/surfaces, and it can't do e.g. drag and drop. Any idea why that could be?

[Kircheneer]

Yeah @nightscape also hinted there were a couple of remaining problems, unfortunately I lack the API knowledge to properly troubleshoot this

[molnarg]

Looks like there's a second property we might need to set on the emitted event besides mouseType, called mouseButton, see https://developer.apple.com/documentation/coregraphics/cgevent. There's also a code sample at https://programmersought.com/article/20392219070/ that sets that to simulate a click. I might give it a try later if you don't have time for it.

[nightscape]

I created a PR that fixes left mouse clicks for me: #1122
Can you give it a try @Kircheneer @molnarg ?

[molnarg]

It does work for me, thanks for implementing it!

It looks like in macos, things like double click and drag and drop are handled specially at this API level though and will need more work - two left clicks with the keyboard don't trigger a double click, or click+move+release doesn't trigger a drag and drop. :( But, now it's usable for most of the day-to-day basic mouse tasks!!