@cdc/dashboard 4.26.4 → 4.26.5

package/examples/dashboard-conditions-filters-incomplete.json

@@ -0,0 +1,221 @@
+{
+  "type": "dashboard",
+  "version": "4.26.4",
+  "dashboard": {
+    "theme": "theme-blue",
+    "title": "Dashboard Conditions: Incomplete Filters",
+    "titleStyle": "small",
+    "description": "<p>This example demonstrates the <code>filtersIncomplete</code>, <code>hasData</code>, and <code>hasNoData</code> dashboard condition operators with one shared filter.</p>",
+    "sharedFilters": [
+      {
+        "key": "County",
+        "label": "County",
+        "type": "datafilter",
+        "filterStyle": "dropdown",
+        "columnName": "county",
+        "showDropdown": true,
+        "resetLabel": "- Select a county -",
+        "active": "- Select a county -",
+        "values": ["Adams County", "Baker County", "Clark County"],
+        "orderedValues": ["Adams County", "Baker County", "Clark County"],
+        "usedBy": [
+          "condition-filters-incomplete",
+          "condition-county-has-data",
+          "condition-county-has-no-data",
+          "condition-row-has-data",
+          "condition-row-has-no-data"
+        ]
+      }
+    ]
+  },
+  "rows": [
+    {
+      "columns": [
+        {
+          "width": 12,
+          "widget": "dashboard-filters"
+        }
+      ],
+      "expandCollapseAllButtons": false
+    },
+    {
+      "columns": [
+        {
+          "width": 12,
+          "conditionalWidgets": [
+            {
+              "widget": "state-filters-incomplete",
+              "dashboardCondition": {
+                "id": "condition-filters-incomplete",
+                "operator": "filtersIncomplete"
+              }
+            },
+            {
+              "widget": "state-has-data",
+              "dashboardCondition": {
+                "id": "condition-county-has-data",
+                "datasetKey": "condition-demo-data",
+                "operator": "hasData"
+              }
+            },
+            {
+              "widget": "state-has-no-data",
+              "dashboardCondition": {
+                "id": "condition-county-has-no-data",
+                "datasetKey": "condition-demo-data",
+                "operator": "hasNoData"
+              }
+            }
+          ]
+        }
+      ],
+      "expandCollapseAllButtons": false
+    },
+    {
+      "dashboardCondition": {
+        "id": "condition-row-has-data",
+        "datasetKey": "condition-demo-data",
+        "operator": "hasData"
+      },
+      "columns": [
+        {
+          "width": 6,
+          "widget": "details-has-data-left"
+        },
+        {
+          "width": 6,
+          "widget": "details-has-data-right"
+        }
+      ],
+      "expandCollapseAllButtons": false
+    },
+    {
+      "dashboardCondition": {
+        "id": "condition-row-has-no-data",
+        "datasetKey": "condition-demo-data",
+        "operator": "hasNoData"
+      },
+      "columns": [
+        {
+          "width": 12,
+          "widget": "details-has-no-data"
+        }
+      ],
+      "expandCollapseAllButtons": false
+    }
+  ],
+  "visualizations": {
+    "dashboard-filters": {
+      "uid": "dashboard-filters",
+      "type": "dashboardFilters",
+      "visualizationType": "dashboardFilters",
+      "sharedFilterIndexes": [0],
+      "filterBehavior": "Filter Change",
+      "autoLoad": true
+    },
+    "state-filters-incomplete": {
+      "uid": "state-filters-incomplete",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "inlineHTML": "<h2>Filters are incomplete</h2><p>This component is visible because its dashboard condition uses <code>operator: filtersIncomplete</code>.</p><p>The County filter is applicable to this condition id and is currently at its reset state. The hard-coded dashboard message is intentionally bypassed because this dashboard authored its own incomplete-filter state.</p>",
+        "showHeader": true,
+        "srcUrl": "",
+        "title": "Filters Incomplete State",
+        "useInlineHTML": true
+      }
+    },
+    "state-has-data": {
+      "uid": "state-has-data",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "inlineHTML": "<h2>Filtered data exists</h2><p>This component is visible because the selected County has at least one matching row in <code>condition-demo-data</code>.</p><p>The neighboring incomplete-filter and no-data components are hidden because their conditions do not match.</p>",
+        "showHeader": true,
+        "srcUrl": "",
+        "title": "Has Data State",
+        "useInlineHTML": true
+      }
+    },
+    "state-has-no-data": {
+      "uid": "state-has-no-data",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "inlineHTML": "<h2>No matching data</h2><p>This component is visible because the selected County has no matching rows in <code>condition-demo-data</code>.</p><p>This is different from the reset state: the filter is complete, the condition dataset is loaded, and <code>hasNoData</code> can safely render an authored no-results message.</p>",
+        "showHeader": true,
+        "srcUrl": "",
+        "title": "Has No Data State",
+        "useInlineHTML": true
+      }
+    },
+    "details-has-data-left": {
+      "uid": "details-has-data-left",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "inlineHTML": "<h3>Row-level hasData condition</h3><p>This whole row appears only when <code>condition-row-has-data</code> passes.</p><p>It demonstrates that row-level conditions and component-level conditional widgets can use the same shared filter targeting model.</p>",
+        "showHeader": true,
+        "srcUrl": "",
+        "title": "Row Has Data Detail",
+        "useInlineHTML": true
+      }
+    },
+    "details-has-data-right": {
+      "uid": "details-has-data-right",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "inlineHTML": "<h3>Why this row hides</h3><p>When the County filter is reset, this data-backed condition is unresolved and the row hides.</p><p>When Clark County is selected, the condition resolves with an empty filtered dataset, so <code>hasData</code> is false and this row hides.</p>",
+        "showHeader": true,
+        "srcUrl": "",
+        "title": "Has Data Hide Explanation",
+        "useInlineHTML": true
+      }
+    },
+    "details-has-no-data": {
+      "uid": "details-has-no-data",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "inlineHTML": "<h3>Row-level hasNoData condition</h3><p>This row appears only when the County filter is complete and the filtered condition dataset is empty.</p><p>It stays hidden during reset because reset filters leave data-backed operators unresolved rather than pretending there is no data.</p>",
+        "showHeader": true,
+        "srcUrl": "",
+        "title": "Row Has No Data Detail",
+        "useInlineHTML": true
+      }
+    }
+  },
+  "datasets": {
+    "condition-demo-data": {
+      "data": [
+        {
+          "county": "Adams County",
+          "status": "Has data",
+          "value": 42
+        },
+        {
+          "county": "Baker County",
+          "status": "Has data",
+          "value": 27
+        }
+      ],
+      "dataFileName": "condition-demo-data.json",
+      "dataFileSourceType": "file",
+      "dataFileFormat": "JSON",
+      "preview": true
+    }
+  },
+  "table": {
+    "label": "Data Table",
+    "show": false,
+    "showDownloadUrl": false,
+    "showVertical": true
+  }
+}

package/examples/dashboard-missing-datasets-multi.json

@@ -0,0 +1,174 @@
+{
+  "type": "dashboard",
+  "version": "4.26.5",
+  "activeDashboard": 0,
+  "dashboard": {
+    "theme": "theme-blue",
+    "title": "Tab 1: Missing datasets"
+  },
+  "rows": [
+    {
+      "columns": [
+        {
+          "width": 12,
+          "widget": "multi-missing-markup"
+        }
+      ]
+    },
+    {
+      "columns": [
+        {
+          "width": 12,
+          "widget": "multi-missing-chart"
+        }
+      ]
+    }
+  ],
+  "visualizations": {
+    "multi-missing-markup": {
+      "uid": "multi-missing-markup",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "title": "Tab 1",
+        "showHeader": true,
+        "srcUrl": "",
+        "useInlineHTML": true,
+        "inlineHTML": "<p>This tab has no datasets object entries for its chart.</p>"
+      }
+    },
+    "multi-missing-chart": {
+      "uid": "multi-missing-chart",
+      "type": "chart",
+      "visualizationType": "Bar",
+      "title": "Missing dataset key",
+      "dataKey": "missing-multi-dataset",
+      "xAxis": {
+        "dataKey": "Category"
+      },
+      "series": [
+        {
+          "dataKey": "Value"
+        }
+      ],
+      "theme": "theme-blue"
+    }
+  },
+  "datasets": {},
+  "multiDashboards": [
+    {
+      "label": "Missing Dataset",
+      "type": "dashboard",
+      "version": "4.26.5",
+      "dashboard": {
+        "theme": "theme-blue",
+        "title": "Tab 1: Missing datasets",
+        "description": "<p>This sub-dashboard has no datasets object entries at all.</p>"
+      },
+      "rows": [
+        {
+          "columns": [
+            {
+              "width": 12,
+              "widget": "multi-missing-markup"
+            }
+          ]
+        },
+        {
+          "columns": [
+            {
+              "width": 12,
+              "widget": "multi-missing-chart"
+            }
+          ]
+        }
+      ],
+      "visualizations": {
+        "multi-missing-markup": {
+          "uid": "multi-missing-markup",
+          "type": "markup-include",
+          "visualizationType": "markup-include",
+          "theme": "theme-blue",
+          "contentEditor": {
+            "title": "Tab 1",
+            "showHeader": true,
+            "srcUrl": "",
+            "useInlineHTML": true,
+            "inlineHTML": "<p>This tab has no datasets object entries for its chart.</p>"
+          }
+        },
+        "multi-missing-chart": {
+          "uid": "multi-missing-chart",
+          "type": "chart",
+          "visualizationType": "Bar",
+          "title": "Missing dataset key",
+          "dataKey": "missing-multi-dataset",
+          "xAxis": {
+            "dataKey": "Category"
+          },
+          "series": [
+            {
+              "dataKey": "Value"
+            }
+          ],
+          "theme": "theme-blue"
+        }
+      },
+      "datasets": {}
+    },
+    {
+      "label": "Empty Dataset",
+      "type": "dashboard",
+      "version": "4.26.5",
+      "dashboard": {
+        "theme": "theme-blue",
+        "title": "Tab 2: Empty datasets",
+        "description": "<p>This sub-dashboard has a datasets object, but the dataset is empty.</p>"
+      },
+      "rows": [
+        {
+          "columns": [
+            {
+              "width": 12,
+              "widget": "multi-empty-chart"
+            }
+          ]
+        }
+      ],
+      "visualizations": {
+        "multi-empty-chart": {
+          "uid": "multi-empty-chart",
+          "type": "chart",
+          "visualizationType": "Bar",
+          "title": "Empty dataset key",
+          "dataKey": "empty-multi-dataset",
+          "xAxis": {
+            "dataKey": "Category"
+          },
+          "series": [
+            {
+              "dataKey": "Value"
+            }
+          ],
+          "theme": "theme-blue"
+        }
+      },
+      "datasets": {
+        "empty-multi-dataset": {
+          "data": [],
+          "preview": true,
+          "dataFileName": "empty-multi-dataset.json",
+          "dataFileSourceType": "file",
+          "dataFileFormat": "JSON"
+        }
+      }
+    }
+  ],
+  "table": {
+    "label": "Data Table",
+    "show": false,
+    "showDownloadUrl": false,
+    "showVertical": true
+  }
+}

package/examples/dashboard-missing-datasets-single.json

@@ -0,0 +1,121 @@
+{
+  "type": "dashboard",
+  "version": "4.26.5",
+  "dashboard": {
+    "theme": "theme-blue",
+    "title": "Regression: Missing Datasets (Single Dashboard)",
+    "description": "<p>This fixture intentionally mixes a missing dataset key and an empty dataset so dashboard loading can skip dataset preparation safely.</p>"
+  },
+  "rows": [
+    {
+      "columns": [
+        {
+          "width": 12,
+          "widget": "intro-single-missing"
+        }
+      ]
+    },
+    {
+      "columns": [
+        {
+          "width": 6,
+          "widget": "chart-missing-dataset"
+        },
+        {
+          "width": 6,
+          "widget": "chart-empty-dataset"
+        }
+      ]
+    },
+    {
+      "dataKey": "missing-row-dataset",
+      "dataDescription": {
+        "horizontal": false,
+        "series": false
+      },
+      "columns": [
+        {
+          "width": 12,
+          "widget": "chart-row-missing-dataset"
+        }
+      ]
+    }
+  ],
+  "visualizations": {
+    "intro-single-missing": {
+      "uid": "intro-single-missing",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "title": "Fixture notes",
+        "showHeader": true,
+        "srcUrl": "",
+        "useInlineHTML": true,
+        "inlineHTML": "<p><strong>Expected:</strong> the dashboard loads without crashing even though one viz points at a missing dataset, one viz points at an empty dataset, and one row points at a missing dataset.</p>"
+      }
+    },
+    "chart-missing-dataset": {
+      "uid": "chart-missing-dataset",
+      "type": "chart",
+      "visualizationType": "Bar",
+      "title": "Missing dataset",
+      "dataKey": "missing-dataset",
+      "xAxis": {
+        "dataKey": "Category"
+      },
+      "series": [
+        {
+          "dataKey": "Value"
+        }
+      ],
+      "theme": "theme-blue"
+    },
+    "chart-empty-dataset": {
+      "uid": "chart-empty-dataset",
+      "type": "chart",
+      "visualizationType": "Bar",
+      "title": "Empty dataset",
+      "dataKey": "empty-dataset",
+      "xAxis": {
+        "dataKey": "Category"
+      },
+      "series": [
+        {
+          "dataKey": "Value"
+        }
+      ],
+      "theme": "theme-blue"
+    },
+    "chart-row-missing-dataset": {
+      "uid": "chart-row-missing-dataset",
+      "type": "chart",
+      "visualizationType": "Bar",
+      "title": "Row with missing dataset",
+      "xAxis": {
+        "dataKey": "Category"
+      },
+      "series": [
+        {
+          "dataKey": "Value"
+        }
+      ],
+      "theme": "theme-blue"
+    }
+  },
+  "datasets": {
+    "empty-dataset": {
+      "data": [],
+      "preview": true,
+      "dataFileName": "empty-dataset.json",
+      "dataFileSourceType": "file",
+      "dataFileFormat": "JSON"
+    }
+  },
+  "table": {
+    "label": "Data Table",
+    "show": false,
+    "showDownloadUrl": false,
+    "showVertical": true
+  }
+}

package/examples/dashboard-multi-dashboard-version-regression.json

@@ -0,0 +1,146 @@
+{
+  "type": "dashboard",
+  "version": "4.25.0",
+  "activeDashboard": 0,
+  "dashboard": {
+    "theme": "theme-blue",
+    "title": "Sub-dashboard keeps its own version"
+  },
+  "rows": [
+    {
+      "columns": [
+        {
+          "width": 12,
+          "widget": "versioned-subdash-markup"
+        }
+      ]
+    }
+  ],
+  "visualizations": {
+    "versioned-subdash-markup": {
+      "uid": "versioned-subdash-markup",
+      "type": "markup-include",
+      "visualizationType": "markup-include",
+      "theme": "theme-blue",
+      "contentEditor": {
+        "title": "Versioned sub-dashboard",
+        "showHeader": true,
+        "srcUrl": "",
+        "useInlineHTML": true,
+        "inlineHTML": "<p>This top-level copy mirrors the first sub-dashboard so the multi-dashboard loader can open tab 1 immediately.</p>"
+      }
+    }
+  },
+  "datasets": {},
+  "multiDashboards": [
+    {
+      "label": "Explicit Version",
+      "type": "dashboard",
+      "version": "4.26.2",
+      "dashboard": {
+        "theme": "theme-blue",
+        "title": "Sub-dashboard keeps its own version",
+        "description": "<p>This tab already has its own version. It should not fall back to the parent version.</p>"
+      },
+      "rows": [
+        {
+          "columns": [
+            {
+              "width": 12,
+              "widget": "versioned-subdash-markup"
+            }
+          ]
+        },
+        {
+          "columns": [
+            {
+              "width": 12,
+              "widget": "versioned-subdash-chart"
+            }
+          ]
+        }
+      ],
+      "visualizations": {
+        "versioned-subdash-markup": {
+          "uid": "versioned-subdash-markup",
+          "type": "markup-include",
+          "visualizationType": "markup-include",
+          "theme": "theme-blue",
+          "contentEditor": {
+            "title": "Explicit version",
+            "showHeader": true,
+            "srcUrl": "",
+            "useInlineHTML": true,
+            "inlineHTML": "<p>Because this sub-dashboard is already at <code>4.26.2</code>, older migrations should not rerun on each load.</p>"
+          }
+        },
+        "versioned-subdash-chart": {
+          "uid": "versioned-subdash-chart",
+          "type": "chart",
+          "visualizationType": "Bar",
+          "title": "Brush should remain if version is respected",
+          "xAxis": {
+            "dataKey": "Category"
+          },
+          "series": [
+            {
+              "dataKey": "Value"
+            }
+          ],
+          "brush": {
+            "enabled": true
+          },
+          "data": [
+            {
+              "Category": "A",
+              "Value": 1
+            },
+            {
+              "Category": "B",
+              "Value": 2
+            }
+          ],
+          "theme": "theme-blue"
+        }
+      },
+      "datasets": {}
+    },
+    {
+      "label": "Fallback Version",
+      "type": "dashboard",
+      "dashboard": {
+        "theme": "theme-blue",
+        "title": "Sub-dashboard receives fallback version",
+        "description": "<p>This tab intentionally omits its own version. It should inherit the parent version during worker processing and then retain a stamped version so migrations do not rerun on every reload.</p>"
+      },
+      "rows": [
+        {
+          "columns": [
+            {
+              "width": 12,
+              "widget": "fallback-subdash-markup"
+            }
+          ]
+        }
+      ],
+      "visualizations": {
+        "fallback-subdash-markup": {
+          "uid": "fallback-subdash-markup",
+          "type": "markup-include",
+          "visualizationType": "markup-include",
+          "contentEditor": {
+            "title": "Fallback version tab"
+          },
+          "theme": "theme-blue"
+        }
+      },
+      "datasets": {}
+    }
+  ],
+  "table": {
+    "label": "Data Table",
+    "show": false,
+    "showDownloadUrl": false,
+    "showVertical": true
+  }
+}