tree: allow floats to be pinned

toml-spec/spec/spec.generated.json

@@ -636,6 +636,10 @@
         "color-management": {
           "description": "Configures the color-management settings.\n\n- Example:\n\n  ```toml\n  [color-management]\n  enabled = true\n  ```\n",
           "$ref": "#/$defs/ColorManagement"
+        },
+        "float": {
+          "description": "Configures the settings of floating windows.\n\n- Example:\n\n  ```toml\n  [float]\n  show-pin-icon = true\n  ```\n",
+          "$ref": "#/$defs/Float"
         }
       },
       "required": []
@@ -808,6 +812,17 @@
         }
       ]
     },
+    "Float": {
+      "description": "Describes settings of floating windows.\n\n- Example:\n\n  ```toml\n  [float]\n  show-pin-icon = true\n  ```\n",
+      "type": "object",
+      "properties": {
+        "show-pin-icon": {
+          "type": "boolean",
+          "description": "Sets whether floating windows always show a pin icon.\n\nThe default is `false`.\n"
+        }
+      },
+      "required": []
+    },
     "Format": {
       "type": "string",
       "description": "A graphics format.\n\nThese formats are documented in https://github.com/torvalds/linux/blob/master/include/uapi/drm/drm_fourcc.h\n\n- Example:\n\n  ```toml\n  [[outputs]]\n  match.serial-number = \"33K03894SL0\"\n  format = \"rgb565\"\n  ```\n",
@@ -1284,7 +1299,10 @@
         "disable-window-management",
         "enable-float-above-fullscreen",
         "disable-float-above-fullscreen",
-        "toggle-float-above-fullscreen"
+        "toggle-float-above-fullscreen",
+        "pin-float",
+        "unpin-float",
+        "toggle-float-pinned"
       ]
     },
     "Status": {

toml-spec/spec/spec.generated.md

@@ -1265,6 +1265,19 @@ The table has the following fields:
 
   The value of this field should be a [ColorManagement](#types-ColorManagement).
 
+- `float` (optional):
+
+  Configures the settings of floating windows.
+  
+  - Example:
+  
+    ```toml
+    [float]
+    show-pin-icon = true
+    ```
+
+  The value of this field should be a [Float](#types-Float).
+
 
 <a name="types-Connector"></a>
 ### `Connector`
@@ -1629,6 +1642,31 @@ The table has the following fields:
   The value of this field should be a boolean.
 
 
+<a name="types-Float"></a>
+### `Float`
+
+Describes settings of floating windows.
+
+- Example:
+
+  ```toml
+  [float]
+  show-pin-icon = true
+  ```
+
+Values of this type should be tables.
+
+The table has the following fields:
+
+- `show-pin-icon` (optional):
+
+  Sets whether floating windows always show a pin icon.
+  
+  The default is `false`.
+
+  The value of this field should be a boolean.
+
+
 <a name="types-Format"></a>
 ### `Format`
 
@@ -2905,6 +2943,21 @@ The string should have one of the following values:
 
   Toggles floating windows showing above fullscreen windows.
 
+- `pin-float`:
+
+  Pins the currently focused floating window.
+  
+  If a floating window is pinned, it will stay visible even when switching to a
+  different workspace.
+
+- `unpin-float`:
+
+  Unpins the currently focused floating window.
+
+- `toggle-float-pinned`:
+
+  Toggles whether the currently focused floating window is pinned.
+
 
 
 <a name="types-Status"></a>

toml-spec/spec/spec.yaml

@@ -712,6 +712,18 @@ SimpleActionName:
     - value: toggle-float-above-fullscreen
       description: |
         Toggles floating windows showing above fullscreen windows.
+    - value: pin-float
+      description: |
+        Pins the currently focused floating window.
+        
+        If a floating window is pinned, it will stay visible even when switching to a
+        different workspace.
+    - value: unpin-float
+      description: |
+        Unpins the currently focused floating window.
+    - value: toggle-float-pinned
+      description: |
+        Toggles whether the currently focused floating window is pinned.
 
 
 Color:
@@ -2326,6 +2338,18 @@ Config:
           [color-management]
           enabled = true
           ```
+    float:
+      ref: Float
+      required: false
+      description: |
+        Configures the settings of floating windows.
+
+        - Example:
+        
+          ```toml
+          [float]
+          show-pin-icon = true
+          ```
 
 
 Idle:
@@ -2834,3 +2858,24 @@ Brightness:
     - kind: number
       description: |
         The brightness in cd/m^2.
+
+
+Float:
+  kind: table
+  description: |
+    Describes settings of floating windows.
+    
+    - Example:
+    
+      ```toml
+      [float]
+      show-pin-icon = true
+      ```
+  fields:
+    show-pin-icon:
+      description: |
+        Sets whether floating windows always show a pin icon.
+        
+        The default is `false`.
+      kind: boolean
+      required: false