yaml-flow 5.1.0 → 5.2.0

package/examples/example-board/cards/card-ex-actions.json

@@ -1,32 +0,0 @@
-{
-  "id": "card-ex-actions",
-  "meta": {
-    "title": "Action Router",
-    "tags": ["actions", "interactive"],
-    "desc": "Simple button actions routed through board-level handler"
-  },
-  "view": {
-    "elements": [
-      {
-        "kind": "actions",
-        "label": "Workflow Actions",
-        "data": {
-          "buttons": [
-            { "id": "approve", "label": "Approve", "style": "success" },
-            { "id": "needs-review", "label": "Needs Review", "style": "warning" },
-            { "id": "escalate", "label": "Escalate", "style": "danger" }
-          ]
-        }
-      },
-      {
-        "kind": "text",
-        "label": "Last Action",
-        "data": { "bind": "card_data.lastActionText", "style": "muted" }
-      }
-    ],
-    "layout": { "board": { "col": 4, "order": 14 }, "canvas": { "x": 980, "y": 320, "w": 260, "h": 180 } }
-  },
-  "card_data": {
-    "lastActionText": "No action yet"
-  }
-}

package/examples/example-board/cards/card-ex-chart.json

@@ -1,30 +0,0 @@
-{
-  "id": "card-ex-chart",
-  "meta": {
-    "title": "Orders by Region",
-    "tags": [],
-    "desc": "Bar chart — JSONata group-by region with count aggregation"
-  },
-  "requires": ["orders"],
-  "compute": [
-    {
-      "bindTo": "regionCounts",
-      "expr": "$each($reduce(requires.orders, function($acc, $v){ $merge([$acc, { $v.region: ($lookup($acc, $v.region) ? $lookup($acc, $v.region) + 1 : 1) }]) }, {}), function($v, $k){ { 'region': $k, 'count': $v } })"
-    }
-  ],
-  "view": {
-    "elements": [
-      {
-        "kind": "chart",
-        "label": "Orders by Region",
-        "data": {
-          "bind": "computed_values.regionCounts",
-          "chartType": "bar",
-          "chartOptions": { "indexAxis": "x" }
-        }
-      }
-    ],
-    "layout": { "board": { "col": 6, "order": 6 }, "canvas": { "x": 50, "y": 530, "w": 350, "h": 220 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-filter.json

@@ -1,36 +0,0 @@
-{
-  "id": "card-ex-filter",
-  "meta": {
-    "title": "Filters",
-    "tags": [],
-    "desc": "Interactive filter controls — user selects region and product"
-  },
-  "requires": ["orders"],
-  "provides": [{ "bindTo": "selections", "src": "card_data.fieldValues" }],
-  "compute": [
-    { "bindTo": "region",  "expr": "$sort($distinct(requires.orders.region))" },
-    { "bindTo": "product", "expr": "$sort($distinct(requires.orders.product))" }
-  ],
-  "view": {
-    "elements": [
-      {
-        "kind": "filter",
-        "data": {
-          "bind": "computed_values",
-          "writeTo": "card_data.fieldValues",
-          "fields": {
-            "type": "object",
-            "properties": {
-              "region":  { "type": "string", "title": "Region" },
-              "product": { "type": "string", "title": "Product" }
-            }
-          }
-        }
-      }
-    ],
-    "layout": { "board": { "col": 4, "order": 3 }, "canvas": { "x": 50, "y": 320, "w": 220, "h": 160 } }
-  },
-  "card_data": {
-    "fieldValues": {}
-  }
-}

package/examples/example-board/cards/card-ex-filtered-by-preference.json

@@ -1,59 +0,0 @@
-{
-  "id": "card-ex-filtered-by-preference",
-  "meta": {
-    "title": "Orders by Favorite Product",
-    "tags": ["filtered", "computed"],
-    "desc": "Shows orders filtered by the Favorite Product selected in the preferences form. Demonstrates cascading updates: when form changes, this card auto-recomputes."
-  },
-  "requires": ["orders", "card-ex-form"],
-  "compute": [
-    {
-      "bindTo": "favoriteProduct",
-      "expr": "($lookup(requires, 'card-ex-form').preferences.favoriteProduct) ? $lookup(requires, 'card-ex-form').preferences.favoriteProduct : 'Widget A'"
-    },
-    {
-      "bindTo": "filteredOrders",
-      "expr": "$filter(requires.orders, function($v){ $v.product = computed_values.favoriteProduct })"
-    },
-    {
-      "bindTo": "filteredCount",
-      "expr": "$count(computed_values.filteredOrders)"
-    },
-    {
-      "bindTo": "filteredRevenue",
-      "expr": "$round($sum(computed_values.filteredOrders.amount), 2)"
-    }
-  ],
-  "view": {
-    "elements": [
-      {
-        "kind": "metric",
-        "label": "Filtered Product",
-        "data": { "bind": "computed_values.favoriteProduct" }
-      },
-      {
-        "kind": "metric",
-        "label": "Order Count",
-        "data": { "bind": "computed_values.filteredCount" }
-      },
-      {
-        "kind": "metric",
-        "label": "Total Revenue",
-        "data": { "bind": "computed_values.filteredRevenue" }
-      },
-      {
-        "kind": "list",
-        "label": "Orders",
-        "data": {
-          "bind": "computed_values.filteredOrders",
-          "template": "{id} | {product} | Qty {quantity} | ${amount} | {region}"
-        }
-      }
-    ],
-    "layout": {
-      "board": { "col": 4, "order": 13 },
-      "canvas": { "x": 920, "y": 400, "w": 300, "h": 250 }
-    }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-form.json

@@ -1,91 +0,0 @@
-{
-  "id": "card-ex-form",
-  "meta": {
-    "title": "Widget Preferences",
-    "tags": [
-      "form",
-      "settings"
-    ],
-    "desc": "Form to update user preferences — demonstrates bidirectional data flow and card state mutations"
-  },
-  "provides": [
-    {
-      "bindTo": "card-ex-form",
-      "src": "card_data"
-    }
-  ],
-  "view": {
-    "elements": [
-      {
-        "kind": "form",
-        "label": "Update Preferences",
-        "data": {
-          "writeTo": "card_data.preferences",
-          "fields": {
-            "type": "object",
-            "title": "Widget Preferences",
-            "properties": {
-              "favoriteProduct": {
-                "type": "string",
-                "title": "Favorite Product",
-                "enum": [
-                  "Widget A",
-                  "Widget B",
-                  "Widget C"
-                ],
-                "description": "Your preferred widget type"
-              },
-              "preferredRegion": {
-                "type": "string",
-                "title": "Preferred Region",
-                "enum": [
-                  "North",
-                  "South",
-                  "East",
-                  "West"
-                ],
-                "description": "Your sales region"
-              },
-              "discountThreshold": {
-                "type": "number",
-                "title": "Discount Threshold ($)",
-                "minimum": 0,
-                "maximum": 100000,
-                "description": "Minimum order amount for discounts"
-              },
-              "enableNotifications": {
-                "type": "boolean",
-                "title": "Enable Email Notifications",
-                "description": "Receive alerts for order updates"
-              }
-            },
-            "required": [
-              "favoriteProduct",
-              "preferredRegion"
-            ]
-          }
-        }
-      }
-    ],
-    "layout": {
-      "board": {
-        "col": 4,
-        "order": 12
-      },
-      "canvas": {
-        "x": 600,
-        "y": 400,
-        "w": 280,
-        "h": 200
-      }
-    }
-  },
-  "card_data": {
-    "preferences": {
-      "favoriteProduct": "Widget C",
-      "preferredRegion": "North",
-      "discountThreshold": 5000,
-      "enableNotifications": true
-    }
-  }
-}

package/examples/example-board/cards/card-ex-list.json

@@ -1,22 +0,0 @@
-{
-  "id": "card-ex-list",
-  "meta": {
-    "title": "Top 5 Products",
-    "tags": [],
-    "desc": "Ranked list — JSONata sort by revenue descending, slice top 5"
-  },
-  "requires": ["orders"],
-  "compute": [
-    {
-      "bindTo": "topProducts",
-      "expr": "requires.orders^(>amount)#$i[$i<5].(product & ' — $' & $string(amount))"
-    }
-  ],
-  "view": {
-    "elements": [
-      { "kind": "list", "data": { "bind": "computed_values.topProducts" } }
-    ],
-    "layout": { "board": { "col": 3, "order": 5 }, "canvas": { "x": 550, "y": 320, "w": 220, "h": 180 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-markdown.json

@@ -1,17 +0,0 @@
-{
-  "id": "card-ex-markdown",
-  "meta": {
-    "title": "Board Notes",
-    "tags": [],
-    "desc": "Free-text markdown notes — no source or compute"
-  },
-  "view": {
-    "elements": [
-      { "kind": "markdown", "data": { "bind": "card_data.content" } }
-    ],
-    "layout": { "board": { "col": 4, "order": 9 }, "canvas": { "x": 700, "y": 530, "w": 260, "h": 200 } }
-  },
-  "card_data": {
-    "content": "## Quick Notes\n\n- Review regional targets quarterly\n- Check supplier delivery SLAs\n- Update pricing model before next sprint"
-  }
-}

package/examples/example-board/cards/card-ex-metric.json

@@ -1,19 +0,0 @@
-{
-  "id": "card-ex-metric",
-  "meta": {
-    "title": "Total Revenue",
-    "tags": [],
-    "desc": "Single KPI — sum of all order amounts via JSONata $sum"
-  },
-  "requires": ["orders"],
-  "compute": [
-    { "bindTo": "totalRevenue", "expr": "$round($sum(requires.orders.amount), 2)" }
-  ],
-  "view": {
-    "elements": [
-      { "kind": "metric", "label": "Revenue", "data": { "bind": "computed_values.totalRevenue" } }
-    ],
-    "layout": { "board": { "col": 3, "order": 4 }, "canvas": { "x": 320, "y": 320, "w": 180, "h": 120 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-narrative.json

@@ -1,36 +0,0 @@
-{
-  "id": "card-ex-narrative",
-  "meta": {
-    "title": "Sales Insight",
-    "tags": [],
-    "desc": "AI-generated narrative from Copilot source execution"
-  },
-  "requires": ["orders", "prices"],
-  "compute": [
-    {
-      "bindTo": "orderCount",
-      "expr": "$count(requires.orders)"
-    },
-    {
-      "bindTo": "totalRevenue",
-      "expr": "$sum(requires.orders.amount)"
-    }
-  ],
-  "sources": [
-    {
-      "bindTo": "raw",
-      "outputFile": "card-ex-narrative-raw.json",
-      "copilot": {
-        "prompt_template": "You are a concise sales analyst. Write 5-7 bullet points about business signals to monitor this week for a small B2B widget company. Keep it under 120 words."
-      }
-    }
-  ],
-  "view": {
-    "elements": [
-      { "kind": "narrative", "data": { "bind": "fetched_sources.raw" } }
-    ],
-    "layout": { "board": { "col": 6, "order": 10 }, "canvas": { "x": 600, "y": 800, "w": 350, "h": 250 } },
-    "features": { "refresh": true, "chat": true }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-source-http.json

@@ -1,28 +0,0 @@
-{
-  "id": "card-ex-source-http",
-  "meta": {
-    "title": "Product Prices",
-    "tags": ["data", "linked"],
-    "desc": "Fetches pricing for products derived from upstream order data"
-  },
-  "requires": ["orders"],
-  "provides": [{ "bindTo": "prices", "src": "fetched_sources.raw" }],
-  "sources": [{
-    "bindTo": "raw",
-    "outputFile": "card-ex-source-http-raw.json",
-    "mock": "prices"
-  }],
-  "compute": [
-    {
-      "bindTo": "PRODUCT_LIST",
-      "expr": "$join($distinct(requires.orders.product), ',')"
-    }
-  ],
-  "view": {
-    "elements": [
-      { "kind": "table", "data": { "bind": "fetched_sources.raw", "columns": ["product", "price", "currency"], "sortable": true } }
-    ],
-    "layout": { "board": { "col": 6, "order": 2 }, "canvas": { "x": 450, "y": 50, "w": 350, "h": 220 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-source.json

@@ -1,21 +0,0 @@
-{
-  "id": "card-ex-source",
-  "meta": {
-    "title": "Order Data",
-    "tags": ["data"],
-    "desc": "Root data source — fetches order records via a script"
-  },
-  "provides": [{ "bindTo": "orders", "src": "fetched_sources.raw" }],
-  "sources": [{
-    "bindTo": "raw",
-    "outputFile": "card-ex-source-raw.json",
-    "mock": "orders"
-  }],
-  "view": {
-    "elements": [
-      { "kind": "table", "data": { "bind": "fetched_sources.raw", "columns": ["id", "product", "quantity", "amount", "region"], "maxRows": 10 } }
-    ],
-    "layout": { "board": { "col": 6, "order": 1 }, "canvas": { "x": 50, "y": 50, "w": 350, "h": 220 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-status.json

@@ -1,35 +0,0 @@
-{
-  "id": "card-ex-status",
-  "meta": {
-    "title": "Revenue Health",
-    "tags": [],
-    "desc": "Status badge with threshold logic — JSONata ternary for green/amber/red"
-  },
-  "requires": ["orders"],
-  "compute": [
-    { "bindTo": "totalRevenue", "expr": "$sum(requires.orders.amount)" },
-    { "bindTo": "orderCount",   "expr": "$count(requires.orders)" },
-    {
-      "bindTo": "health",
-      "expr": "computed_values.totalRevenue > 100000 ? { 'label': 'Healthy', 'value': computed_values.totalRevenue, 'orders': computed_values.orderCount } : computed_values.totalRevenue > 50000 ? { 'label': 'Moderate', 'value': computed_values.totalRevenue, 'orders': computed_values.orderCount } : { 'label': 'Low', 'value': computed_values.totalRevenue, 'orders': computed_values.orderCount }"
-    }
-  ],
-  "view": {
-    "elements": [
-      {
-        "kind": "badge",
-        "data": {
-          "bind": "computed_values.health.label",
-          "colorMap": { "Healthy": "success", "Moderate": "warning", "Low": "danger" }
-        }
-      },
-      {
-        "kind": "metric",
-        "label": "Revenue",
-        "data": { "bind": "computed_values.health.value" }
-      }
-    ],
-    "layout": { "board": { "col": 3, "order": 8 }, "canvas": { "x": 450, "y": 530, "w": 200, "h": 170 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-table.json

@@ -1,30 +0,0 @@
-{
-  "id": "card-ex-table",
-  "meta": {
-    "title": "Order Details",
-    "tags": [],
-    "desc": "Filtered and sorted table — combines source data with user filter selections"
-  },
-  "requires": ["orders", "selections"],
-  "compute": [
-    {
-      "bindTo": "filtered",
-      "expr": "[$filter(requires.orders, function($v){ ($exists(requires.selections.region) ? $v.region = requires.selections.region : true) and ($exists(requires.selections.product) ? $v.product = requires.selections.product : true) })^(>amount)#$i[$i<20]]"
-    }
-  ],
-  "view": {
-    "elements": [
-      {
-        "kind": "table",
-        "data": {
-          "bind": "computed_values.filtered",
-          "columns": ["id", "product", "quantity", "amount", "region"],
-          "sortable": true,
-          "maxRows": 20
-        }
-      }
-    ],
-    "layout": { "board": { "col": 8, "order": 7 }, "canvas": { "x": 50, "y": 800, "w": 500, "h": 250 } }
-  },
-  "card_data": {}
-}

package/examples/example-board/cards/card-ex-todo.json

@@ -1,29 +0,0 @@
-{
-  "id": "card-ex-todo",
-  "meta": {
-    "title": "Action Items",
-    "tags": [],
-    "desc": "Interactive todo list — persistent user input via writeTo"
-  },
-  "view": {
-    "elements": [
-      {
-        "kind": "todo",
-        "label": "Tasks",
-        "data": {
-          "bind": "card_data.items",
-          "writeTo": "card_data.items",
-          "placeholder": "No tasks yet — add one above"
-        }
-      }
-    ],
-    "layout": { "board": { "col": 4, "order": 11 }, "canvas": { "x": 700, "y": 320, "w": 260, "h": 180 } }
-  },
-  "card_data": {
-    "items": [
-      { "text": "Set up task-executor for your data sources", "done": false },
-      { "text": "Configure board.yaml connections", "done": false },
-      { "text": "Run board-live-cards-cli init", "done": false }
-    ]
-  }
-}

package/examples/example-board/mock.db

@@ -1,15 +0,0 @@
-{
-  "orders": [
-    { "id": "ORD-1001", "product": "Widget A", "quantity": 3, "amount": 12400, "region": "North" },
-    { "id": "ORD-1002", "product": "Widget B", "quantity": 2, "amount": 8700, "region": "South" },
-    { "id": "ORD-1003", "product": "Widget A", "quantity": 4, "amount": 15200, "region": "East" },
-    { "id": "ORD-1004", "product": "Widget C", "quantity": 1, "amount": 6300, "region": "West" },
-    { "id": "ORD-1005", "product": "Widget B", "quantity": 2, "amount": 9100, "region": "North" },
-    { "id": "ORD-1006", "product": "Widget C", "quantity": 3, "amount": 9800, "region": "South" }
-  ],
-  "prices": [
-    { "product": "Widget A", "price": 4133.33, "currency": "USD" },
-    { "product": "Widget B", "price": 4450.0, "currency": "USD" },
-    { "product": "Widget C", "price": 3266.67, "currency": "USD" }
-  ]
-}