Document animation TOML settings

toml-spec/spec/spec.yaml

@@ -2942,6 +2942,22 @@ Config:
           ```toml
           ui-drag = { enabled = false, threshold = 20 }
           ```
+    animations:
+      ref: Animations
+      required: false
+      description: |
+        Configures window animations.
+
+        Animations are disabled by default.
+
+        - Example:
+
+          ```toml
+          [animations]
+          enabled = true
+          duration-ms = 160
+          curve = "ease-out"
+          ```
     xwayland:
       ref: Xwayland
       required: false
@@ -3655,6 +3671,74 @@ UiDrag:
         The default is `10`.
 
 
+Animations:
+  kind: table
+  description: |
+    Describes window animation settings.
+
+    - Example:
+
+      ```toml
+      [animations]
+      enabled = true
+      duration-ms = 160
+      curve = [0.25, 0.1, 0.25, 1.0]
+      ```
+  fields:
+    enabled:
+      kind: boolean
+      required: false
+      description: |
+        Enables or disables window animations.
+
+        The default is `false`.
+    duration-ms:
+      kind: number
+      integer_only: true
+      required: false
+      description: |
+        Sets the animation duration in milliseconds.
+
+        The default is `160`.
+    curve:
+      ref: AnimationCurve
+      required: false
+      description: |
+        Sets the animation curve.
+
+        The default is `ease-out`.
+
+
+AnimationCurve:
+  kind: variable
+  description: |
+    Describes a window animation curve.
+  variants:
+    - kind: string
+      description: |
+        One of the supported curve presets.
+      values:
+        - value: linear
+          description: No easing.
+        - value: ease
+          description: The CSS `ease` curve.
+        - value: ease-in
+          description: The CSS `ease-in` curve.
+        - value: ease-out
+          description: The CSS `ease-out` curve.
+        - value: ease-in-out
+          description: The CSS `ease-in-out` curve.
+    - kind: array
+      items:
+        kind: number
+      description: |
+        A custom CSS-style cubic-bezier curve as four numbers:
+        `x1`, `y1`, `x2`, and `y2`.
+
+        The implicit endpoints are `(0, 0)` and `(1, 1)`. `x1` and `x2` must
+        be between `0` and `1`.
+
+
 Xwayland:
   kind: table
   description: |