From f19788100ba2f1065b36b9eb4308271cba4a5d72 Mon Sep 17 00:00:00 2001 From: LGUG2Z Date: Tue, 10 Nov 2026 14:02:35 -0800 Subject: [PATCH] docs(starlight): regenerate the macOS references with just docgen The pages the unified macOS binaries and schemas make, as of this commit: the commands the site did not have yet (consume, expel, pan and others) and the changed help of the rules. The Windows pages are not regenerated: komorebic for Windows does not run on this host. Co-Authored-By: Claude Sonnet 5.5 --- .../src/content/docs/reference/bar-macos.mdx | 4 +- .../content/docs/reference/komorebi-macos.mdx | 210 +++++++++++++++++- .../src/data/cli/macos/animation-duration.md | 9 +- .../src/data/cli/macos/animation-style.md | 7 +- starlight/src/data/cli/macos/animation.md | 9 +- starlight/src/data/cli/macos/border-colour.md | 11 +- starlight/src/data/cli/macos/center-focus.md | 10 + starlight/src/data/cli/macos/consume.md | 14 ++ .../cli/macos/cross-monitor-move-behaviour.md | 6 +- starlight/src/data/cli/macos/expand.md | 11 + starlight/src/data/cli/macos/expel.md | 11 + starlight/src/data/cli/macos/ignore-rule.md | 2 +- .../cli/macos/initial-named-workspace-rule.md | 2 +- .../data/cli/macos/initial-workspace-rule.md | 2 +- starlight/src/data/cli/macos/manage-rule.md | 2 +- .../data/cli/macos/monocle-focus-behaviour.md | 18 ++ .../data/cli/macos/named-workspace-rule.md | 2 +- starlight/src/data/cli/macos/pan.md | 43 ++++ starlight/src/data/cli/macos/query.md | 4 +- .../cli/macos/scrolling-layout-full-width.md | 11 + .../src/data/cli/macos/toggle-column-stack.md | 11 + .../macos/toggle-monocle-focus-behaviour.md | 10 + .../macos/toggle-workspace-float-override.md | 4 +- ...le-workspace-window-container-behaviour.md | 3 +- .../src/data/cli/macos/workspace-rule.md | 2 +- 25 files changed, 387 insertions(+), 31 deletions(-) create mode 100644 starlight/src/data/cli/macos/center-focus.md create mode 100644 starlight/src/data/cli/macos/consume.md create mode 100644 starlight/src/data/cli/macos/expand.md create mode 100644 starlight/src/data/cli/macos/expel.md create mode 100644 starlight/src/data/cli/macos/monocle-focus-behaviour.md create mode 100644 starlight/src/data/cli/macos/pan.md create mode 100644 starlight/src/data/cli/macos/scrolling-layout-full-width.md create mode 100644 starlight/src/data/cli/macos/toggle-column-stack.md create mode 100644 starlight/src/data/cli/macos/toggle-monocle-focus-behaviour.md diff --git a/starlight/src/content/docs/reference/bar-macos.mdx b/starlight/src/content/docs/reference/bar-macos.mdx index 18a7cf81..659857f1 100644 --- a/starlight/src/content/docs/reference/bar-macos.mdx +++ b/starlight/src/content/docs/reference/bar-macos.mdx @@ -1,6 +1,6 @@ --- -title: "komorebi.bar.json (macOS)" -description: "komorebi-bar for Mac configuration schema reference" +title: "komorebi.bar.json (macos)" +description: "komorebi-bar configuration schema reference for macos" --- import { Badge } from '@astrojs/starlight/components'; diff --git a/starlight/src/content/docs/reference/komorebi-macos.mdx b/starlight/src/content/docs/reference/komorebi-macos.mdx index 4e67c0cd..e86072f0 100644 --- a/starlight/src/content/docs/reference/komorebi-macos.mdx +++ b/starlight/src/content/docs/reference/komorebi-macos.mdx @@ -1,6 +1,6 @@ --- -title: "komorebi.json (macOS)" -description: "komorebi for Mac configuration schema reference" +title: "komorebi.json (macos)" +description: "komorebi configuration schema reference for macos" --- import { Badge } from '@astrojs/starlight/components'; @@ -285,6 +285,18 @@ Monitor and workspace configurations +--- +### monocle_focus_behaviour {#monocle_focus_behaviour} + + [`MonocleFocusBehaviour`](#monoclefocusbehaviour) + +Determine what happens when focusing in a direction while a monocle container is active + + + +**Default:** [`"NoOp"`](#monoclefocusbehaviour) + + --- ### mouse_follows_focus {#mouse_follows_focus} @@ -864,7 +876,7 @@ Ease in out bounce #### CubicBezier -Custom Cubic Bézier function +Custom Cubic Bezier function @@ -880,6 +892,7 @@ Custom Cubic Bézier function **Configuration:** - [`.animation.style`](#peranimationprefixconfig3) +- [`.animation.style[*]`](#peranimationprefixconfig3) **Referenced by:** @@ -1040,7 +1053,7 @@ Executable name #### Class -Role or subrole +Accessibility subrole or role, such as AXStandardWindow @@ -1120,7 +1133,7 @@ Aspect ratio for temporarily floating windows #### Predefined -A predefined aspect ratio +Predefined aspect ratio @@ -1136,7 +1149,7 @@ A predefined aspect ratio #### Custom -A custom W:H aspect ratio +Custom W:H aspect ratio @@ -7758,6 +7771,59 @@ Workspace padding (default: global) +--- + + +### MonocleFocusBehaviour {#monoclefocusbehaviour} + +Behaviour when focusing in a direction while a monocle container is active + + + + +
+Enum variants (2) + + +--- + +#### Cycle + + +Cycle the monocle container to the next/previous container in the workspace + + + + +**Value:** `"Cycle"` + + + + +--- + +#### NoOp + + +Do nothing, allowing focus to fall through to cross-monitor logic + + + + +**Value:** `"NoOp"` + + + + +
+#### Usages + +**Configuration:** +- [`.monocle_focus_behaviour`](#monocle_focus_behaviour) + + + + --- @@ -8322,6 +8388,84 @@ Red +--- + + +### ScrollingCentering {#scrollingcentering} + +When the Scrolling layout centres the focused column + +A boolean is also accepted when reading, for the layout option that used to be one: `true` is +`Always` and `false` is `Never`. + + + + +
+Enum variants (3) + + +--- + +#### Never + + +Scroll just far enough to bring the focused column into view, and no further + + + + +**Value:** `"Never"` + + + + +--- + +#### Always + + +Keep the focused column in the middle of the screen + + + + +**Value:** `"Always"` + + + + +--- + +#### OnOverflow + + +Centre the focused column when it does not fit on the screen together with the column that +focus came from + + + + +**Value:** `"OnOverflow"` + + + + +
+#### Usages + +**Configuration:** +- [`.layout_defaults[*].layout_options.scrolling.center_focused_column`](#scrollinglayoutoptions-center_focused_column) +- [`.layout_defaults[*].layout_options_rules[*].scrolling.center_focused_column`](#scrollinglayoutoptions-center_focused_column) +- [`.monitors[].workspaces[].layout_options.scrolling.center_focused_column`](#scrollinglayoutoptions-center_focused_column) +- [`.monitors[].workspaces[].layout_options_rules[*].scrolling.center_focused_column`](#scrollinglayoutoptions-center_focused_column) + + +**Referenced by:** +- [`ScrollingLayoutOptions`](#scrollinglayoutoptions) + + + --- @@ -8348,12 +8492,62 @@ Desired number of visible columns (default: 3) #### center_focused_column {#scrollinglayoutoptions-center_focused_column} - `boolean` +`enum` -With an odd number of visible columns, keep the focused window column centered +When to centre the focused column: `Never` (the default), `Always`, or `OnOverflow`, which +is when it does not fit on the screen together with the column that focus came from. A +boolean is also accepted, where `true` is `Always` and `false` is `Never` +
+Enum variants (3) + + +--- + +#### Boolean + + + + + + +**Value:** `boolean` + + + + +--- + +#### ScrollingCentering + + + + + + +**Value:** [`ScrollingCentering`](#scrollingcentering) + + + + +--- + +#### Null + + + + + + +**Value:** `null` + + + + +
+ #### Usages diff --git a/starlight/src/data/cli/macos/animation-duration.md b/starlight/src/data/cli/macos/animation-duration.md index 0ebf22b9..77d73166 100644 --- a/starlight/src/data/cli/macos/animation-duration.md +++ b/starlight/src/data/cli/macos/animation-duration.md @@ -10,10 +10,13 @@ Arguments: Options: -a, --animation-type Animation type to apply the duration to. If not specified, sets global duration - - [possible values: movement] + + Possible values: + - movement + - transparency + - workspace: A workspace sliding in and out of a monitor when it is switched to -h, --help - Print help + Print help (see a summary with '-h') ``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/animation-style.md b/starlight/src/data/cli/macos/animation-style.md index c0af8dd8..e28e65a8 100644 --- a/starlight/src/data/cli/macos/animation-style.md +++ b/starlight/src/data/cli/macos/animation-style.md @@ -44,8 +44,11 @@ Options: -a, --animation-type Animation type to apply the style to. If not specified, sets global style - - [possible values: movement] + + Possible values: + - movement + - transparency + - workspace: A workspace sliding in and out of a monitor when it is switched to -h, --help Print help (see a summary with '-h') diff --git a/starlight/src/data/cli/macos/animation.md b/starlight/src/data/cli/macos/animation.md index d14e4f3c..d537ff95 100644 --- a/starlight/src/data/cli/macos/animation.md +++ b/starlight/src/data/cli/macos/animation.md @@ -10,10 +10,13 @@ Arguments: Options: -a, --animation-type Animation type to apply the state to. If not specified, sets global state - - [possible values: movement] + + Possible values: + - movement + - transparency + - workspace: A workspace sliding in and out of a monitor when it is switched to -h, --help - Print help + Print help (see a summary with '-h') ``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/border-colour.md b/starlight/src/data/cli/macos/border-colour.md index b248aa0e..867d036a 100644 --- a/starlight/src/data/cli/macos/border-colour.md +++ b/starlight/src/data/cli/macos/border-colour.md @@ -15,10 +15,17 @@ Arguments: Options: -w, --window-kind + Possible values: + - single: Single window + - stack: Stack container + - monocle: Monocle container + - unfocused: Unfocused window + - unfocused-locked: Unfocused locked container + - floating: Floating window + [default: single] - [possible values: single, stack, monocle, unfocused, unfocused-locked, floating] -h, --help - Print help + Print help (see a summary with '-h') ``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/center-focus.md b/starlight/src/data/cli/macos/center-focus.md new file mode 100644 index 00000000..8d321dc9 --- /dev/null +++ b/starlight/src/data/cli/macos/center-focus.md @@ -0,0 +1,10 @@ +``` +Scroll the Scrolling layout so that the focused column is in the middle of the screen, once + +Usage: center-focus + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/consume.md b/starlight/src/data/cli/macos/consume.md new file mode 100644 index 00000000..10397301 --- /dev/null +++ b/starlight/src/data/cli/macos/consume.md @@ -0,0 +1,14 @@ +``` +Take the neighbouring window on one side into the focused column of the Scrolling layout + +Usage: consume + +Arguments: + + [possible values: left, right, up, down] + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/cross-monitor-move-behaviour.md b/starlight/src/data/cli/macos/cross-monitor-move-behaviour.md index 1b338fbb..856e89a5 100644 --- a/starlight/src/data/cli/macos/cross-monitor-move-behaviour.md +++ b/starlight/src/data/cli/macos/cross-monitor-move-behaviour.md @@ -6,9 +6,11 @@ Usage: cross-monitor-move-behaviour Arguments: Possible values: - - swap: Swap the window container with the window container at the edge of the adjacent monitor + - swap: Swap the window container with the window container at the edge of the adjacent + monitor - insert: Insert the window container into the focused workspace on the adjacent monitor - - no-op: Do nothing if trying to move a window container in the direction of an adjacent monitor + - no-op: Do nothing if trying to move a window container in the direction of an adjacent + monitor Options: -h, --help diff --git a/starlight/src/data/cli/macos/expand.md b/starlight/src/data/cli/macos/expand.md new file mode 100644 index 00000000..2f8f132b --- /dev/null +++ b/starlight/src/data/cli/macos/expand.md @@ -0,0 +1,11 @@ +``` +Make the focused column of the Scrolling layout fill the room that the columns in view leave on the +screen, which does nothing in any other layout + +Usage: expand + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/expel.md b/starlight/src/data/cli/macos/expel.md new file mode 100644 index 00000000..35c8c142 --- /dev/null +++ b/starlight/src/data/cli/macos/expel.md @@ -0,0 +1,11 @@ +``` +Take the focused window out of its column in the Scrolling layout and put it in a column of its own +on the right + +Usage: expel + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/ignore-rule.md b/starlight/src/data/cli/macos/ignore-rule.md index f1041a98..3c2b02a7 100644 --- a/starlight/src/data/cli/macos/ignore-rule.md +++ b/starlight/src/data/cli/macos/ignore-rule.md @@ -7,7 +7,7 @@ Arguments: Possible values: - exe: Executable name - - class: Role or subrole + - class: Accessibility subrole or role, such as AXStandardWindow - title: Window title - path: Executable path diff --git a/starlight/src/data/cli/macos/initial-named-workspace-rule.md b/starlight/src/data/cli/macos/initial-named-workspace-rule.md index 19807c7e..26b7f259 100644 --- a/starlight/src/data/cli/macos/initial-named-workspace-rule.md +++ b/starlight/src/data/cli/macos/initial-named-workspace-rule.md @@ -7,7 +7,7 @@ Arguments: Possible values: - exe: Executable name - - class: Role or subrole + - class: Accessibility subrole or role, such as AXStandardWindow - title: Window title - path: Executable path diff --git a/starlight/src/data/cli/macos/initial-workspace-rule.md b/starlight/src/data/cli/macos/initial-workspace-rule.md index 849c9b39..39582638 100644 --- a/starlight/src/data/cli/macos/initial-workspace-rule.md +++ b/starlight/src/data/cli/macos/initial-workspace-rule.md @@ -7,7 +7,7 @@ Arguments: Possible values: - exe: Executable name - - class: Role or subrole + - class: Accessibility subrole or role, such as AXStandardWindow - title: Window title - path: Executable path diff --git a/starlight/src/data/cli/macos/manage-rule.md b/starlight/src/data/cli/macos/manage-rule.md index ec8987c9..fbe8d278 100644 --- a/starlight/src/data/cli/macos/manage-rule.md +++ b/starlight/src/data/cli/macos/manage-rule.md @@ -7,7 +7,7 @@ Arguments: Possible values: - exe: Executable name - - class: Role or subrole + - class: Accessibility subrole or role, such as AXStandardWindow - title: Window title - path: Executable path diff --git a/starlight/src/data/cli/macos/monocle-focus-behaviour.md b/starlight/src/data/cli/macos/monocle-focus-behaviour.md new file mode 100644 index 00000000..c1819035 --- /dev/null +++ b/starlight/src/data/cli/macos/monocle-focus-behaviour.md @@ -0,0 +1,18 @@ +``` +Set the behaviour when focusing in a direction while a monocle container is active + +Usage: monocle-focus-behaviour + +Arguments: + + Desired monocle focus behaviour + + Possible values: + - cycle: Cycle the monocle container to the next/previous container in the workspace + - no-op: Do nothing, allowing focus to fall through to cross-monitor logic + +Options: + -h, --help + Print help (see a summary with '-h') + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/named-workspace-rule.md b/starlight/src/data/cli/macos/named-workspace-rule.md index 1cbdbac7..0c9bb74c 100644 --- a/starlight/src/data/cli/macos/named-workspace-rule.md +++ b/starlight/src/data/cli/macos/named-workspace-rule.md @@ -7,7 +7,7 @@ Arguments: Possible values: - exe: Executable name - - class: Role or subrole + - class: Accessibility subrole or role, such as AXStandardWindow - title: Window title - path: Executable path diff --git a/starlight/src/data/cli/macos/pan.md b/starlight/src/data/cli/macos/pan.md new file mode 100644 index 00000000..096c8d69 --- /dev/null +++ b/starlight/src/data/cli/macos/pan.md @@ -0,0 +1,43 @@ +``` +Move the view of the Scrolling layout a column to the left or the right, or with the fingers on a +touchpad + +The strip of columns moves by the width of a new column and comes to rest with a column against an +edge of the screen. Focus stays on the column that has it if that is still fully in view, and +otherwise goes to the nearest column that is. Only the Scrolling layout has a strip to move, so this +does nothing in the other layouts. + +With --stream the strip follows the fingers as they go, 10 centimetres of travel being the width of +the screen, until they lift, and then comes to rest in the column that the speed that they lifted at +takes it to. Standard input is the gesture stream that whkd writes on Windows, one message to a +line: `begin`, `move dx= t=`, `end` and `cancel`. A gesture that is not finished when +standard input closes is given up, and the strip goes back to where it was. + +Usage: pan [OPTIONS] [DIRECTION] + +Arguments: + [DIRECTION] + The way that the view goes + + [possible values: left, right] + +Options: + --stream + Read the gestures of fingers on a touchpad from standard input, in the gesture stream that + whkd writes for a swipe of three or four fingers, and pan with them + + --sensitivity + What the distances of a gesture are multiplied by, which is 1 if it is left out, with + --stream + + --reversed + Go the other way to the fingers, with --stream + + --paging + Take a step for every two centimetres that the fingers go, and not move the view with + them, with --stream + + -h, --help + Print help (see a summary with '-h') + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/query.md b/starlight/src/data/cli/macos/query.md index a8a0b13e..441e2543 100644 --- a/starlight/src/data/cli/macos/query.md +++ b/starlight/src/data/cli/macos/query.md @@ -5,7 +5,9 @@ Usage: query Arguments: - [possible values: focused-monitor-index, focused-workspace-index, focused-container-index, focused-window-index, focused-workspace-name, focused-workspace-layout, focused-container-kind, version] + [possible values: focused-monitor-index, focused-workspace-index, focused-container-index, + focused-window-index, focused-workspace-name, focused-workspace-layout, + focused-container-kind, version] Options: -h, --help diff --git a/starlight/src/data/cli/macos/scrolling-layout-full-width.md b/starlight/src/data/cli/macos/scrolling-layout-full-width.md new file mode 100644 index 00000000..8b244afe --- /dev/null +++ b/starlight/src/data/cli/macos/scrolling-layout-full-width.md @@ -0,0 +1,11 @@ +``` +Make the focused column of the Scrolling layout as wide as the screen, or put it back to the width +that it had + +Usage: scrolling-layout-full-width + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/toggle-column-stack.md b/starlight/src/data/cli/macos/toggle-column-stack.md new file mode 100644 index 00000000..3792569c --- /dev/null +++ b/starlight/src/data/cli/macos/toggle-column-stack.md @@ -0,0 +1,11 @@ +``` +Stack the windows of the focused column of the Scrolling layout, or spread the focused stack out +into a column with a window in each slot + +Usage: toggle-column-stack + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/toggle-monocle-focus-behaviour.md b/starlight/src/data/cli/macos/toggle-monocle-focus-behaviour.md new file mode 100644 index 00000000..0ce7c2da --- /dev/null +++ b/starlight/src/data/cli/macos/toggle-monocle-focus-behaviour.md @@ -0,0 +1,10 @@ +``` +Toggle the behaviour when focusing in a direction while a monocle container is active + +Usage: toggle-monocle-focus-behaviour + +Options: + -h, --help + Print help + +``` \ No newline at end of file diff --git a/starlight/src/data/cli/macos/toggle-workspace-float-override.md b/starlight/src/data/cli/macos/toggle-workspace-float-override.md index aab69696..b2ecb015 100644 --- a/starlight/src/data/cli/macos/toggle-workspace-float-override.md +++ b/starlight/src/data/cli/macos/toggle-workspace-float-override.md @@ -1,5 +1,7 @@ ``` -Enable or disable float override, which makes it so every new window opens in floating mode, for the currently focused workspace. If there was no override value set for the workspace previously it takes the opposite of the global value +Enable or disable float override, which makes it so every new window opens in floating mode, for the +currently focused workspace. If there was no override value set for the workspace previously it +takes the opposite of the global value Usage: toggle-workspace-float-override diff --git a/starlight/src/data/cli/macos/toggle-workspace-window-container-behaviour.md b/starlight/src/data/cli/macos/toggle-workspace-window-container-behaviour.md index 8c7fdf08..12d3d13a 100644 --- a/starlight/src/data/cli/macos/toggle-workspace-window-container-behaviour.md +++ b/starlight/src/data/cli/macos/toggle-workspace-window-container-behaviour.md @@ -1,5 +1,6 @@ ``` -Toggle the behaviour for new windows (stacking or dynamic tiling) for currently focused workspace. If there was no behaviour set for the workspace previously it takes the opposite of the global value +Toggle the behaviour for new windows (stacking or dynamic tiling) for currently focused workspace. +If there was no behaviour set for the workspace previously it takes the opposite of the global value Usage: toggle-workspace-window-container-behaviour diff --git a/starlight/src/data/cli/macos/workspace-rule.md b/starlight/src/data/cli/macos/workspace-rule.md index 3319b80c..11384cba 100644 --- a/starlight/src/data/cli/macos/workspace-rule.md +++ b/starlight/src/data/cli/macos/workspace-rule.md @@ -7,7 +7,7 @@ Arguments: Possible values: - exe: Executable name - - class: Role or subrole + - class: Accessibility subrole or role, such as AXStandardWindow - title: Window title - path: Executable path