docs(schema): regenerate the schemas for the scrolling layout

schema.json gets the center_focused_column layout option as a boolean or one
of Never, Always and OnOverflow, and schema.bar.json, which embeds the socket
messages, gets the new scrolling commands.

docs/cli/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
+
+```

docs/cli/consume.md

@@ -0,0 +1,14 @@
+```
+Take the neighbouring window on one side into the focused column of the Scrolling layout
+
+Usage: consume <OPERATION_DIRECTION>
+
+Arguments:
+  <OPERATION_DIRECTION>
+          [possible values: left, right, up, down]
+
+Options:
+  -h, --help
+          Print help
+
+```

docs/cli/expand.md

@@ -0,0 +1,10 @@
+```
+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
+
+```

docs/cli/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
+
+```

docs/cli/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
+
+```

docs/cli/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
+
+```

schema.bar.json

@@ -5208,16 +5208,44 @@
         }
       ]
     },
+    "ScrollingCentering": {
+      "description": "When the Scrolling layout centres the focused column\n\nA boolean is also accepted when reading, for the layout option that used to be one: `true` is\n`Always` and `false` is `Never`.",
+      "oneOf": [
+        {
+          "description": "Scroll just far enough to bring the focused column into view, and no further",
+          "type": "string",
+          "const": "Never"
+        },
+        {
+          "description": "Keep the focused column in the middle of the screen",
+          "type": "string",
+          "const": "Always"
+        },
+        {
+          "description": "Centre the focused column when it does not fit on the screen together with the column that\nfocus came from",
+          "type": "string",
+          "const": "OnOverflow"
+        }
+      ]
+    },
     "ScrollingLayoutOptions": {
       "description": "Options for the Scrolling layout",
       "type": "object",
       "properties": {
         "center_focused_column": {
-          "description": "With an odd number of visible columns, keep the focused window column centered",
-          "type": [
-            "boolean",
-            "null"
-          ]
+          "description": "When to centre the focused column: `Never` (the default), `Always`, or `OnOverflow`, which\nis when it does not fit on the screen together with the column that focus came from. A\nboolean is also accepted, where `true` is `Always` and `false` is `Never`",
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/$defs/ScrollingCentering"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
         },
         "columns": {
           "description": "Desired number of visible columns (default: 3)",
@@ -6299,6 +6327,82 @@
             "content"
           ]
         },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "ScrollingLayoutFullWidth"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "CenterFocus"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "Expand"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "content": {
+              "$ref": "#/$defs/OperationDirection"
+            },
+            "type": {
+              "type": "string",
+              "const": "Consume"
+            }
+          },
+          "required": [
+            "type",
+            "content"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "Expel"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "ToggleColumnStack"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
         {
           "type": "object",
           "properties": {

schema.json

@@ -3854,16 +3854,44 @@
         "b"
       ]
     },
+    "ScrollingCentering": {
+      "description": "When the Scrolling layout centres the focused column\n\nA boolean is also accepted when reading, for the layout option that used to be one: `true` is\n`Always` and `false` is `Never`.",
+      "oneOf": [
+        {
+          "description": "Scroll just far enough to bring the focused column into view, and no further",
+          "type": "string",
+          "const": "Never"
+        },
+        {
+          "description": "Keep the focused column in the middle of the screen",
+          "type": "string",
+          "const": "Always"
+        },
+        {
+          "description": "Centre the focused column when it does not fit on the screen together with the column that\nfocus came from",
+          "type": "string",
+          "const": "OnOverflow"
+        }
+      ]
+    },
     "ScrollingLayoutOptions": {
       "description": "Options for the Scrolling layout",
       "type": "object",
       "properties": {
         "center_focused_column": {
-          "description": "With an odd number of visible columns, keep the focused window column centered",
-          "type": [
-            "boolean",
-            "null"
-          ]
+          "description": "When to centre the focused column: `Never` (the default), `Always`, or `OnOverflow`, which\nis when it does not fit on the screen together with the column that focus came from. A\nboolean is also accepted, where `true` is `Always` and `false` is `Never`",
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "#/$defs/ScrollingCentering"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
         },
         "columns": {
           "description": "Desired number of visible columns (default: 3)",