Add animation style toggle

toml-spec/spec/spec.generated.json

@@ -665,8 +665,16 @@
         }
       ]
     },
+    "AnimationStyle": {
+      "type": "string",
+      "description": "Describes a tiled window movement animation style.\n",
+      "enum": [
+        "plain",
+        "multiphase"
+      ]
+    },
     "Animations": {
-      "description": "Describes window animation settings.\n\n- Example:\n\n  ```toml\n  [animations]\n  enabled = true\n  duration-ms = 160\n  curve = [0.25, 0.1, 0.25, 1.0]\n  ```\n",
+      "description": "Describes window animation settings.\n\n- Example:\n\n  ```toml\n  [animations]\n  enabled = true\n  duration-ms = 160\n  style = \"multiphase\"\n  curve = [0.25, 0.1, 0.25, 1.0]\n  ```\n",
       "type": "object",
       "properties": {
         "enabled": {
@@ -677,6 +685,10 @@
           "type": "integer",
           "description": "Sets the animation duration in milliseconds.\n\nThe default is `160`.\n"
         },
+        "style": {
+          "description": "Sets the animation style used for tiled window movement animations.\n\nThe default is `multiphase`.\n",
+          "$ref": "#/$defs/AnimationStyle"
+        },
         "curve": {
           "description": "Sets the animation curve.\n\nThe default is `ease-out`.\n",
           "$ref": "#/$defs/AnimationCurve"
@@ -1129,7 +1141,7 @@
           "$ref": "#/$defs/UiDrag"
         },
         "animations": {
-          "description": "Configures window animations.\n\nAnimations are disabled by default.\n\n- Example:\n\n  ```toml\n  [animations]\n  enabled = true\n  duration-ms = 160\n  curve = \"ease-out\"\n  ```\n",
+          "description": "Configures window animations.\n\nAnimations are disabled by default.\n\n- Example:\n\n  ```toml\n  [animations]\n  enabled = true\n  duration-ms = 160\n  style = \"multiphase\"\n  curve = \"ease-out\"\n  ```\n",
           "$ref": "#/$defs/Animations"
         },
         "xwayland": {

toml-spec/spec/spec.generated.md

@@ -987,6 +987,26 @@ be between `0` and `1`.
 Each element of this array should be a number.
 
 
+<a name="types-AnimationStyle"></a>
+### `AnimationStyle`
+
+Describes a tiled window movement animation style.
+
+Values of this type should be strings.
+
+The string should have one of the following values:
+
+- `plain`:
+
+  Uses a single interpolated movement from each window's current visual
+  rectangle to its destination rectangle.
+
+- `multiphase`:
+
+  Uses the no-overlap multiphase planner for tiled window movement when a
+  supported plan exists.
+
+
 <a name="types-Animations"></a>
 ### `Animations`
 
@@ -998,6 +1018,7 @@ Describes window animation settings.
   [animations]
   enabled = true
   duration-ms = 160
+  style = "multiphase"
   curve = [0.25, 0.1, 0.25, 1.0]
   ```
 
@@ -1023,6 +1044,14 @@ The table has the following fields:
 
   The numbers should be integers.
 
+- `style` (optional):
+
+  Sets the animation style used for tiled window movement animations.
+
+  The default is `multiphase`.
+
+  The value of this field should be a [AnimationStyle](#types-AnimationStyle).
+
 - `curve` (optional):
 
   Sets the animation curve.
@@ -2271,6 +2300,7 @@ The table has the following fields:
     [animations]
     enabled = true
     duration-ms = 160
+    style = "multiphase"
     curve = "ease-out"
     ```
 

toml-spec/spec/spec.yaml

@@ -2956,6 +2956,7 @@ Config:
           [animations]
           enabled = true
           duration-ms = 160
+          style = "multiphase"
           curve = "ease-out"
           ```
     xwayland:
@@ -3682,6 +3683,7 @@ Animations:
       [animations]
       enabled = true
       duration-ms = 160
+      style = "multiphase"
       curve = [0.25, 0.1, 0.25, 1.0]
       ```
   fields:
@@ -3700,6 +3702,13 @@ Animations:
         Sets the animation duration in milliseconds.
 
         The default is `160`.
+    style:
+      ref: AnimationStyle
+      required: false
+      description: |
+        Sets the animation style used for tiled window movement animations.
+
+        The default is `multiphase`.
     curve:
       ref: AnimationCurve
       required: false
@@ -3709,6 +3718,21 @@ Animations:
         The default is `ease-out`.
 
 
+AnimationStyle:
+  kind: string
+  description: |
+    Describes a tiled window movement animation style.
+  values:
+    - value: plain
+      description: |
+        Uses a single interpolated movement from each window's current visual
+        rectangle to its destination rectangle.
+    - value: multiphase
+      description: |
+        Uses the no-overlap multiphase planner for tiled window movement when a
+        supported plan exists.
+
+
 AnimationCurve:
   kind: variable
   description: |