Commit Graph
19 Commits
Author SHA1 Message Date
LGUG2Z 23aca28267 build(nix): add generated module opts and validation
This commit adds NixOS module option generation for komorebi and
komorebi-bar configurations, along with a nix and JSONSchema validation
test harness that runs as part of `nix flake check`.

`schemars-nixgen` (same as `schemars-docgen`, not sure if I'm gonna
release this...) generates strongly-typed Nix option definitions from
the generated JSONSchema files, allowing users to write type-checked Nix
configurations that map directly to the config files.

This will eventually be plugged into a nix-darwin module which I have
yet to start writing.
2025-12-24 17:18:41 -08:00
LGUG2Z a56f2b42d4 docs(schema): remove custom layout and stackbar refs
This commit removes references to custom layouts and the stackbar as
these are end-of-life komorebi for Windows features which are not being
ported.
2025-12-23 20:07:46 -08:00
LGUG2Z f42457e2e8 feat(animation): add window movement animations
This commit adds window movement animations to komorebi for macOS,
maintaining configuration API compatibility with komorebi for Windows.

The animation system is adapted from the Windows implementation but uses
macOS-specific APIs for screen update batching and accessibility
control, and borrows heavily from the implementation details of
animations in rift.

In order to have decent performance, there are some calls to private
APIS. For this reason, the animation feature will be marked as "UNSAFE".

UNSAFE features should be expected to break between major operating
system updates, and depending on which way I want to go, may only
support one major macOS version at a time (i.e. they will not have a
backwards compatibility guarantee with previous versions of macOS).

This currently look awful when used with the Scrolling layout, but looks
relatively good with other layouts. As with Windows, the animations
when two windows of very different sizes change position aren't great.

Some high level notes on the implementation:

* Uses the private SkyLight framework for screen update batching via
  SLSDisableUpdate/SLSReenableUpdate - these APIs prevent visual flicker
  by compositing all window position changes at once rather than updating
  each window individually during layout operations
* AnimationEngine runs animations in background threads with frame-based
  timing, supporting cancellation when new animations are triggered for
  the same window
* MovementRenderDispatcher implements the RenderDispatcher trait to
  interpolate window positions using configurable easing functions
* All 30+ easing styles from the Windows implementation are supported,
  including standard CSS-style functions and CubicBezier for custom curves
* Enhanced User Interface (AXEnhancedUserInterface) is temporarily
  disabled during window positioning operations for better performance
* The Transparency animation prefix is not supported on macOS as there
  is no equivalent to the Win32 transparency feature

This feature is off-by-default and can be enabled in the static config
or via komorebic commands (animation, animation-duration, animation-fps,
animation-style).
2025-12-23 19:04:33 -08:00
LGUG2Z b09e979af5 feat(wm): promote containers by swapping indices
This commit adds a new SocketMessage variant PromoteSwap and
corresponding komorebic promote-swap command.

PromoteSwap will also promote the focused window container to the
largest tile in the layout, but instead of removing the focused
container x from the Ring and inserting it into position 0, possibly
changing the positions of other windows between 0 and x, the indices x
and 0 in the Ring will be swapped directly.
2025-11-04 07:53:29 -08:00
LGUG2Z 34db2e2c90 feat(wm): add visual feedback for preselections
This commit adds visual feedback in the form of a ghost tile for
preselections made by the preselect-direction command.

A container with the id "PRESELECT" will be added to the workspace, and
replaced when the next manage-able window is spawned.

A new command, cancel-preselect has been added to remove both the
preselection index and the ghost tile if the user changes their mind.
2025-11-02 11:03:11 -08:00
LGUG2Z 3128968634 feat(wm): add direction preselection
This commit adds a new feature to preselect the direction of the next
spawned window with a corresponding komorebic preselect-direction
command which takes an OperationDirection.

If the OperationDirection is valid from the current position, it will be
stored in the Workspace state, and then read, applied, and deleted when
the next manage-able window is spawned.
2025-10-31 15:12:19 -07:00
LGUG2Z 9dbae50909 feat(wm): add a splash screen for mdm devices
A little nudge for people to do the right thing, 1990s vibes.
2025-10-28 18:25:05 -07:00
LGUG2Z 202238aecd docs(mkdocs): add homebrew installation instructions 2025-10-27 12:21:50 -07:00
LGUG2Z f729cc2b81 docs(mkdocs): add notes about system configuration suggestions 2025-10-10 14:25:14 -07:00
LGUG2Z a8a2f923cf style(mkdocs): add information about komorebi-bar 2025-10-06 15:41:12 -07:00
LGUG2Z 9777c55a1f feat(bar): migrate the komorebi-bar
This commit migrates the komorebi-bar from komorebi for Windows. Mostly
lifting and shifting code, exposing stuff we need in komorebi-client
etc.

A few widgets will need to be reworked completely so they have been
removed for now.

Mouse and command stuff also needs updating a little so that has also
been removed for now.
2025-09-30 15:14:30 -07:00
LGUG2Z 0cbf02b604 feat(config): implement border manager options
This commit enables the border, border_width, border_offset and
border_colours options in StaticConfig, and hooks them up to the
relevant variables in the border manager module.
2025-09-30 09:34:14 -07:00
LGUG2Z 7aea35dff1 docs(examples): ensure skhdrc samples don't conflict with mission
control
2025-09-27 15:40:45 -07:00
LGUG2Z cd5f660455 feat(cli): add permissions prompts to quickstart 2025-09-27 13:06:22 -07:00
LGUG2Z fb416e75fd feat(wm): implement move resizing and moving
This commit implements moving and resizing by mouse as it works in
komorebi for Windows. We're able to make this a bit nicer here because
macOS emits separate events for resizing and movement, so now we have
MoveStart/MoveEnd and ResizeStart/ResizeEnd.

Resizing is a little janky because the system does not update the
position of resized windows quickly enough, so if you do a quick drag
and release the left mouse button, sometimes the accessibility
attributes for the size and position of that window won't have been
updated, and no resize will take place.
2025-09-27 10:55:34 -07:00
LGUG2Z 6a194f7e6c docs(mkdocs): initial outline of documentation website 2025-09-26 16:47:20 -07:00
LGUG2Z d0121815ea feat(cli): add enable and disable autostart cmds 2025-09-26 15:47:59 -07:00
LGUG2Z 3792da1bb3 feat(cli): impl quickstart and update config dir
This commit implements the komorebic quickstart command, adds a sample
komorebi.json and a sample skhdrc file which get built into the
komorebic binary, and updates the default config path on macOS to
$HOME/.config/komorebi
2025-09-26 15:10:03 -07:00
LGUG2Z f9dd8cf9f1 docs(mkdocs): add generated markdown docs for cli cmds 2025-09-26 12:50:17 -07:00