fix docs

Signed-off-by: Teo Koon Peng <[email protected]>

Author: koonpeng

diagram.schema.json

@@ -28,6 +28,12 @@
     }
   },
   "definitions": {
+    "BuiltinSource": {
+      "type": "string",
+      "enum": [
+        "start"
+      ]
+    },
     "BuiltinTarget": {
       "oneOf": [
         {
@@ -199,10 +205,11 @@
           }
         },
         {
-          "description": "Wait for an item to be emitted from each of the inputs, then combined the oldest of each into an array.\n\n# Examples ``` # bevy_impulse::Diagram::from_json_str(r#\" { \"version\": \"0.1.0\", \"start\": \"split\", \"ops\": { \"split\": { \"type\": \"split\", \"index\": [\"op1\", \"op2\"] }, \"op1\": { \"type\": \"node\", \"builder\": \"foo\", \"next\": \"join\" }, \"op2\": { \"type\": \"node\", \"builder\": \"bar\", \"next\": \"join\" }, \"join\": { \"type\": \"join\", \"next\": { \"builtin\": \"terminate\" } } } } # \"#)?; # Ok::<_, serde_json::Error>(()) ```",
+          "description": "Wait for an item to be emitted from each of the inputs, then combined the oldest of each into an array.\n\n# Examples ``` # bevy_impulse::Diagram::from_json_str(r#\" { \"version\": \"0.1.0\", \"start\": \"split\", \"ops\": { \"split\": { \"type\": \"split\", \"index\": [\"op1\", \"op2\"] }, \"op1\": { \"type\": \"node\", \"builder\": \"foo\", \"next\": \"join\" }, \"op2\": { \"type\": \"node\", \"builder\": \"bar\", \"next\": \"join\" }, \"join\": { \"type\": \"join\", \"order\": [\"op1\", \"op2\"], \"next\": { \"builtin\": \"terminate\" } } } } # \"#)?; # Ok::<_, serde_json::Error>(()) ```",
           "type": "object",
           "required": [
             "next",
+            "order",
             "type"
           ],
           "properties": {
@@ -216,6 +223,13 @@
                 "null"
               ]
             },
+            "order": {
+              "description": "Controls the order of the resulting join. Each item must be an operation id of one of the incoming outputs.",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/SourceOperation"
+              }
+            },
             "type": {
               "type": "string",
               "enum": [
@@ -281,6 +295,24 @@
           }
         }
       ]
+    },
+    "SourceOperation": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "required": [
+            "builtin"
+          ],
+          "properties": {
+            "builtin": {
+              "$ref": "#/definitions/BuiltinSource"
+            }
+          }
+        }
+      ]
     }
   }
 }

src/diagram.rs

@@ -262,6 +262,7 @@ pub enum DiagramOperation {
     ///         },
     ///         "join": {
     ///             "type": "join",
+    ///             "order": ["op1", "op2"],
     ///             "next": { "builtin": "terminate" }
     ///         }
     ///     }