yaml-flow 8.9.1 → 8.11.0

package/browser/live-cards.schema.json

@@ -139,6 +139,40 @@
         "title": {
           "type": "string"
         },
+        "presentation": {
+          "type": "object",
+          "description": "Semantic presentation hints authored on the card, expressed from the user's perception of the card on the Main Canvas. Content shape is inferred from view.elements[].kind; runtime placement and live drag/resize coordinates are frontend-managed and must not be authored into card JSON.",
+          "properties": {
+            "prominence": {
+              "type": "string",
+              "default": "standard",
+              "description": "How much the user should care about this card / how much attention it earns. Default: standard; omit unless a non-standard value is needed.",
+              "enum": [
+                "glance",
+                "standard",
+                "feature",
+                "spotlight"
+              ]
+            },
+            "footprint": {
+              "type": "string",
+              "default": "standard",
+              "description": "How much room the card wants to render well, independent of attention. Default: standard; omit unless a non-standard value is needed.",
+              "enum": [
+                "compact",
+                "standard",
+                "wide",
+                "large"
+              ]
+            },
+            "resizable": {
+              "type": "boolean",
+              "default": true,
+              "description": "Whether the user may resize this card at runtime. Default: true; omit unless it must be false."
+            }
+          },
+          "additionalProperties": true
+        },
         "tags": {
           "type": "array",
           "items": {
@@ -223,11 +257,6 @@
             "type": "string"
           }
         },
-        "optionalForCompletionGating": {
-          "type": "boolean",
-          "default": false,
-          "description": "When true this source does not gate card completion. Default false when absent, so source_defs are completion-gating by default."
-        },
         "timeout": {
           "type": "integer",
           "minimum": 0,
@@ -436,58 +465,6 @@
           "items": {
             "$ref": "#/definitions/render_element"
           }
-        },
-        "layout": {
-          "type": "object",
-          "properties": {
-            "board": {
-              "type": "object",
-              "properties": {
-                "col": {
-                  "type": "integer",
-                  "minimum": 1,
-                  "maximum": 12
-                },
-                "order": {
-                  "type": "integer"
-                }
-              }
-            },
-            "canvas": {
-              "type": "object",
-              "properties": {
-                "x": {
-                  "type": "number"
-                },
-                "y": {
-                  "type": "number"
-                },
-                "w": {
-                  "type": "number"
-                },
-                "h": {
-                  "type": "number"
-                }
-              }
-            }
-          }
-        },
-        "features": {
-          "type": "object",
-          "properties": {
-            "chat": {
-              "type": "boolean",
-              "default": false
-            },
-            "notes": {
-              "type": "boolean",
-              "default": false
-            },
-            "refresh": {
-              "type": "boolean",
-              "default": true
-            }
-          }
         }
       }
     }
@@ -520,7 +497,7 @@
     },
     "card_data": {
       "type": "object",
-      "description": "Authored card data and runtime metadata. Includes uploaded-file metadata maintained by host handlers and inference evaluation results.",
+      "description": "User editable data on card. Includes uploaded-file metadata maintained by host handlers. Not to be used for card static content.",
       "properties": {
         "files": {
           "type": "array",
@@ -577,7 +554,7 @@
     },
     "source_defs": {
       "type": "array",
-      "description": "Source entries. Each entry is passed verbatim to the board's .task-executor (registered via init --task-executor) as the --in JSON file. The executor fetches/generates the data and writes JSON to --out. If no executor is registered, the built-in executor runs the entry's 'cli' command directly. Sources gate completion by default. Set optionalForCompletionGating: true for enrichment-only source_defs that should not block task-completed.",
+      "description": "Source entries. Each entry is passed verbatim to the board's .task-executor (registered via init --task-executor) as the --in JSON file. The executor fetches/generates the data and writes JSON to --out. If no executor is registered, the built-in executor runs the entry's 'cli' command directly. Sources gate completion.",
       "items": {
         "$ref": "#/definitions/source_def"
       }