@cdc/core 4.25.10 → 4.26.1

package/_stories/Gallery.WaffleChart.stories.tsx

@@ -0,0 +1,187 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+import { within, expect } from 'storybook/test'
+import WaffleChart from '@cdc/waffle-chart'
+
+// Fallback step function for test descriptions
+const step = async (description: string, fn: () => Promise<void> | void) => {
+  console.log(`▶ ${description}`)
+  await fn()
+  console.log(`✓ ${description}`)
+}
+
+const meta: Meta = {
+  title: 'Regression Tests/Gallery/Waffle Charts',
+  parameters: {
+    layout: 'fullscreen',
+    docs: {
+      description: {
+        component: 'Waffle Chart and Gauge visualization examples from the CDC COVE Gallery'
+      }
+    }
+  },
+  tags: ['autodocs']
+}
+
+export default meta
+
+type Story = StoryObj<typeof WaffleChart>
+
+// Helper function to test waffle chart rendering
+const testWaffleChartRendering = async (canvasElement: HTMLElement, storyName: string) => {
+  await step('Wait for waffle chart to render', async () => {
+    // Wait for SVG element to appear
+    await new Promise<void>((resolve, reject) => {
+      const startTime = Date.now()
+      const timeout = 10000
+
+      const checkSvg = () => {
+        const svgElement = canvasElement.querySelector('svg')
+        if (svgElement) {
+          resolve()
+        } else if (Date.now() - startTime > timeout) {
+          reject(new Error(`Timeout: SVG element not found after ${timeout}ms`))
+        } else {
+          setTimeout(checkSvg, 100)
+        }
+      }
+      checkSvg()
+    })
+  })
+
+  await step('Verify SVG element is present', async () => {
+    const svgElement = canvasElement.querySelector('svg')
+    expect(svgElement).toBeInTheDocument()
+  })
+
+  await step('Verify waffle chart container is present', async () => {
+    const waffleContainer = canvasElement.querySelector('.cove-waffle-chart')
+    expect(waffleContainer).toBeInTheDocument()
+  })
+
+  console.log(` ${storyName} waffle chart rendered successfully`)
+}
+
+// Base config for examples
+const baseWaffleConfig = {
+  type: 'waffle-chart',
+  shape: 'person',
+  title: 'Overdose Mortality Rates',
+  content: 'of overdoses resulted in death.',
+  subtext: 'This data is an example and does not reflect actual averages',
+  orientation: 'horizontal',
+  data: [
+    {
+      'Resulted in Death': 250,
+      'Number of Overdoses': 600,
+      state: 'Alabama',
+      Year: '2010'
+    },
+    {
+      'Resulted in Death': 16,
+      'Number of Overdoses': 80,
+      state: 'Alaska',
+      Year: '2008'
+    },
+    {
+      'Resulted in Death': 19,
+      'Number of Overdoses': 100,
+      state: 'Alaska',
+      Year: '2010'
+    },
+    {
+      'Resulted in Death': 93,
+      'Number of Overdoses': 400,
+      state: 'Alaska',
+      Year: '2012'
+    },
+    {
+      'Resulted in Death': 82,
+      'Number of Overdoses': 400,
+      state: 'Arizona',
+      Year: '2010'
+    }
+  ],
+  filters: [],
+  fontSize: null,
+  overallFontSize: 'medium',
+  dataColumn: 'Resulted in Death',
+  dataFunction: 'Sum',
+  dataConditionalColumn: '',
+  dataConditionalOperator: null,
+  dataConditionalComparate: '',
+  customDenom: true,
+  dataDenom: null,
+  dataDenomColumn: 'Number of Overdoses',
+  dataDenomFunction: 'Sum',
+  prefix: '',
+  suffix: '%',
+  roundToPlace: 0,
+  nodeWidth: 10,
+  nodeSpacer: 2,
+  theme: 'theme-blue',
+  invalidComparate: false,
+  showDenominator: false,
+  showPercent: true,
+  valueDescription: 'testing',
+  visual: {
+    border: true,
+    accent: true,
+    background: true,
+    hideBackgroundColor: true,
+    borderColorTheme: true
+  }
+}
+
+export const Waffle_Chart_Person: Story = {
+  render: () => (
+    <WaffleChart
+      config={{
+        ...baseWaffleConfig,
+        visualizationType: 'Waffle',
+        visualizationSubType: '',
+        gauge: {
+          height: 35,
+          width: 400
+        },
+        visual: {
+          border: true,
+          accent: true,
+          background: true,
+          hideBackgroundColor: true,
+          borderColorTheme: true,
+          colors: {
+            'theme-blue': '#005eaa',
+            'theme-purple': '#712177',
+            'theme-brown': '#705043',
+            'theme-teal': '#00695c',
+            'theme-pink': '#af4448',
+            'theme-orange': '#bb4d00',
+            'theme-slate': '#29434e',
+            'theme-indigo': '#26418f',
+            'theme-cyan': '#006778',
+            'theme-green': '#4b830d',
+            'theme-amber': '#fbab18'
+          }
+        }
+      }}
+    />
+  ),
+  play: async ({ canvasElement }) => {
+    await testWaffleChartRendering(canvasElement, 'Waffle Chart Person')
+  }
+}
+
+export const Gauge_Chart: Story = {
+  render: () => (
+    <WaffleChart
+      config={{
+        ...baseWaffleConfig,
+        visualizationType: 'Gauge',
+        visualizationSubType: ''
+      }}
+    />
+  ),
+  play: async ({ canvasElement }) => {
+    await testWaffleChartRendering(canvasElement, 'Gauge Chart')
+  }
+}

package/_stories/PageART.stories.tsx

@@ -0,0 +1,192 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+import { within, expect } from 'storybook/test'
+import Dashboard from '@cdc/dashboard'
+import { useEffect, useState } from 'react'
+
+// Fallback step function for test descriptions
+const step = async (description: string, fn: () => Promise<void> | void) => {
+  console.log(`▶ ${description}`)
+  await fn()
+  console.log(`✓ ${description}`)
+}
+
+const meta: Meta = {
+  title: 'Regression Tests/Pages/ART',
+  parameters: {
+    layout: 'fullscreen',
+    docs: {
+      description: {
+        component: 'Stories for visualizations from the CDC ART (Assisted Reproductive Technology) Surveillance State-Specific page (https://www.cdc.gov/art/php/surveillance-state-specific/index.html)'
+      }
+    }
+  },
+  tags: ['autodocs']
+}
+
+export default meta
+
+// Config URL from the ART surveillance state-specific page
+const CONFIG_URLS = {
+  stateSpecificDashboard: 'https://www.cdc.gov/art/dfe-modules/state-specific-dashboard.json'
+}
+
+// Helper to fetch config and update data URLs to use absolute cdc.gov paths
+const useConfigWithAbsoluteDataUrl = (configUrl: string) => {
+  const [config, setConfig] = useState(null)
+
+  useEffect(() => {
+    fetch(configUrl)
+      .then(res => res.json())
+      .then(data => {
+        // Convert relative data URLs to absolute cdc.gov URLs
+        if (data.dataUrl) {
+          // Handle different relative path formats (../../path or /path)
+          const dataUrl = data.dataUrl.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+          data.dataUrl = `https://www.cdc.gov/${dataUrl}`
+        }
+        if (data.dataFileName) {
+          const dataFileName = data.dataFileName.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+          data.dataFileName = `https://www.cdc.gov/${dataFileName}`
+        }
+
+        // For dashboard configs with multiDashboards, convert dataKey references in visualizations
+        if (data.multiDashboards) {
+          data.multiDashboards.forEach((dashboard: any) => {
+            if (dashboard.visualizations) {
+              Object.values(dashboard.visualizations).forEach((viz: any) => {
+                // Only convert dataKey if it's a URL path (starts with / or ../)
+                if (viz.dataKey && (viz.dataKey.startsWith('/') || viz.dataKey.startsWith('../'))) {
+                  const dataKey = viz.dataKey.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+                  viz.dataKey = `https://www.cdc.gov/${dataKey}`
+                }
+              })
+            }
+          })
+        }
+
+        // For dashboard configs, convert dataKey references in visualizations
+        if (data.visualizations) {
+          Object.values(data.visualizations).forEach((viz: any) => {
+            // Only convert dataKey if it's a URL path (starts with / or ../)
+            if (viz.dataKey && (viz.dataKey.startsWith('/') || viz.dataKey.startsWith('../'))) {
+              const dataKey = viz.dataKey.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+              viz.dataKey = `https://www.cdc.gov/${dataKey}`
+            }
+          })
+        }
+
+        // For dashboard configs, convert datasets only if they reference external files
+        if (data.datasets) {
+          const newDatasets = {}
+          Object.entries(data.datasets).forEach(([key, dataset]: [string, any]) => {
+            // Check if dataset has embedded data
+            const hasEmbeddedData = (dataset as any).data && Array.isArray((dataset as any).data)
+
+            // If data is embedded, keep the original key
+            if (hasEmbeddedData) {
+              newDatasets[key] = dataset
+            } else {
+              // Otherwise, convert paths to absolute URLs
+              const newKey = key.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+              const absoluteKey = `https://www.cdc.gov/${newKey}`
+
+              newDatasets[absoluteKey] = {
+                ...dataset,
+                dataFileName: (dataset as any).dataFileName
+                  ? `https://www.cdc.gov/${(dataset as any).dataFileName.replace(/^(\.\.\/)+/, '').replace(/^\//, '')}`
+                  : (dataset as any).dataFileName,
+                dataUrl: (dataset as any).dataUrl
+                  ? `https://www.cdc.gov/${(dataset as any).dataUrl.replace(/^(\.\.\/)+/, '').replace(/^\//, '')}`
+                  : (dataset as any).dataUrl
+              }
+            }
+          })
+          data.datasets = newDatasets
+        }
+
+        // Set activeDashboard to 0 if it's null and multiDashboards exist
+        if (data.multiDashboards && data.multiDashboards.length > 0 && data.activeDashboard === null) {
+          data.activeDashboard = 0
+        }
+
+        // Log config info for debugging
+        console.log('✓ Config loaded:', {
+          hasMultiDashboards: !!data.multiDashboards,
+          dashboardCount: data.multiDashboards?.length || 0,
+          activeDashboard: data.activeDashboard,
+          datasetCount: Object.keys(data.datasets || {}).length,
+          firstDashboardVizCount: data.multiDashboards?.[0]?.visualizations
+            ? Object.keys(data.multiDashboards[0].visualizations).length
+            : 0
+        })
+
+        setConfig(data)
+      })
+      .catch(err => {
+        console.error('Failed to fetch config:', configUrl, err)
+      })
+  }, [configUrl])
+
+  return config
+}
+
+type DashboardStory = StoryObj<typeof Dashboard>
+
+// Helper function to test dashboard rendering
+const testDashboardRendering = async (canvasElement: HTMLElement, storyName: string) => {
+  await step('Wait for dashboard to render', async () => {
+    await new Promise<void>((resolve, reject) => {
+      const startTime = Date.now()
+      const timeout = 20000
+
+      const checkDashboard = () => {
+        const dashboardElement = canvasElement.querySelector('.cove-dashboard')
+        const loadingDiv = canvasElement.querySelector('div')
+
+        // Log current state for debugging
+        if (!dashboardElement && loadingDiv?.textContent?.includes('Loading')) {
+          console.log('Still loading config...')
+        }
+
+        if (dashboardElement) {
+          resolve()
+        } else if (Date.now() - startTime > timeout) {
+          reject(new Error(`Timeout: Dashboard element not found after ${timeout}ms`))
+        } else {
+          setTimeout(checkDashboard, 100)
+        }
+      }
+      checkDashboard()
+    })
+  })
+
+  await step('Verify dashboard wrapper is present', async () => {
+    const dashboard = canvasElement.querySelector('.cove-dashboard')
+    expect(dashboard).toBeInTheDocument()
+  })
+
+  await step('Verify at least one visualization rendered', async () => {
+    const coveModules = canvasElement.querySelectorAll('.cdc-open-viz-module')
+    expect(coveModules.length).toBeGreaterThan(0)
+  })
+
+  console.log(` ${storyName} dashboard rendered successfully`)
+}
+
+/**
+ * ART State-Specific Surveillance Dashboard
+ *
+ * Interactive dashboard showing Assisted Reproductive Technology (ART) surveillance
+ * data for different states. This visualization allows users to explore state-specific
+ * ART outcomes and trends.
+ */
+export const State_Specific_Dashboard: DashboardStory = {
+  render: () => {
+    const config = useConfigWithAbsoluteDataUrl(CONFIG_URLS.stateSpecificDashboard)
+    if (!config) return <div>Loading...</div>
+    return <Dashboard config={config} />
+  },
+  play: async ({ canvasElement }) => {
+    await testDashboardRendering(canvasElement, 'State Specific Dashboard')
+  }
+}

package/_stories/PageBRFSS.stories.tsx

@@ -0,0 +1,289 @@
+import type { Meta, StoryObj } from '@storybook/react-vite'
+import { within, expect } from 'storybook/test'
+import Dashboard from '@cdc/dashboard'
+import { useEffect, useState } from 'react'
+
+// Fallback step function for test descriptions
+const step = async (description: string, fn: () => Promise<void> | void) => {
+  console.log(`▶ ${description}`)
+  await fn()
+  console.log(`✓ ${description}`)
+}
+
+const meta: Meta = {
+  title: 'Regression Tests/Pages/BRFSS',
+  parameters: {
+    layout: 'fullscreen',
+    docs: {
+      description: {
+        component: 'Stories for visualizations from the CDC Behavioral Risk Factor Surveillance System (BRFSS) Prevalence Data & Data Analysis Tools page (https://www.cdc.gov/brfss/brfssprevalence/index.html)'
+      }
+    }
+  },
+  tags: ['autodocs']
+}
+
+export default meta
+
+// Config URLs from the BRFSS prevalence page
+const CONFIG_URLS = {
+  exploreByLocation: 'https://www.cdc.gov/brfss/brfssprevalence/modules/explore-by-location.json',
+  exploreByTopic: 'https://www.cdc.gov/brfss/brfssprevalence/modules/explore-by-topic.json'
+}
+
+// Helper to fetch config and update data URLs to use absolute cdc.gov paths
+const useConfigWithAbsoluteDataUrl = (configUrl: string) => {
+  const [config, setConfig] = useState(null)
+
+  useEffect(() => {
+    fetch(configUrl)
+      .then(res => res.json())
+      .then(data => {
+        // Convert relative data URLs to absolute cdc.gov URLs
+        if (data.dataUrl) {
+          // Handle different relative path formats (../../path or /path)
+          const dataUrl = data.dataUrl.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+          data.dataUrl = `https://www.cdc.gov/${dataUrl}`
+        }
+        if (data.dataFileName) {
+          const dataFileName = data.dataFileName.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+          data.dataFileName = `https://www.cdc.gov/${dataFileName}`
+        }
+
+        // For dashboard configs with multiDashboards, convert dataKey references in visualizations
+        if (data.multiDashboards) {
+          data.multiDashboards.forEach((dashboard: any) => {
+            if (dashboard.visualizations) {
+              Object.values(dashboard.visualizations).forEach((viz: any) => {
+                // Only convert dataKey if it's a URL path (starts with / or ../)
+                if (viz.dataKey && (viz.dataKey.startsWith('/') || viz.dataKey.startsWith('../'))) {
+                  const dataKey = viz.dataKey.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+                  viz.dataKey = `https://www.cdc.gov/${dataKey}`
+                }
+              })
+            }
+          })
+        }
+
+        // For dashboard configs, convert dataKey references in visualizations
+        if (data.visualizations) {
+          Object.values(data.visualizations).forEach((viz: any) => {
+            // Only convert dataKey if it's a URL path (starts with / or ../)
+            if (viz.dataKey && (viz.dataKey.startsWith('/') || viz.dataKey.startsWith('../'))) {
+              const dataKey = viz.dataKey.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+              viz.dataKey = `https://www.cdc.gov/${dataKey}`
+            }
+          })
+        }
+
+        // For dashboard configs, convert datasets only if they reference external files
+        if (data.datasets) {
+          const newDatasets = {}
+          Object.entries(data.datasets).forEach(([key, dataset]: [string, any]) => {
+            // Check if dataset has embedded data
+            const hasEmbeddedData = (dataset as any).data && Array.isArray((dataset as any).data)
+
+            // If data is embedded, keep the original key
+            if (hasEmbeddedData) {
+              newDatasets[key] = dataset
+            } else {
+              // Otherwise, convert paths to absolute URLs (but keep absolute URLs as-is)
+              const newKey = key.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
+              const absoluteKey = key.startsWith('http') ? key : `https://www.cdc.gov/${newKey}`
+
+              newDatasets[absoluteKey] = {
+                ...dataset,
+                dataFileName: (dataset as any).dataFileName && !(dataset as any).dataFileName.startsWith('http')
+                  ? `https://www.cdc.gov/${(dataset as any).dataFileName.replace(/^(\.\.\/)+/, '').replace(/^\//, '')}`
+                  : (dataset as any).dataFileName,
+                dataUrl: (dataset as any).dataUrl && !(dataset as any).dataUrl.startsWith('http')
+                  ? `https://www.cdc.gov/${(dataset as any).dataUrl.replace(/^(\.\.\/)+/, '').replace(/^\//, '')}`
+                  : (dataset as any).dataUrl
+              }
+            }
+          })
+          data.datasets = newDatasets
+        }
+
+        // Set activeDashboard to 0 if it's null and multiDashboards exist
+        if (data.multiDashboards && data.multiDashboards.length > 0 && data.activeDashboard === null) {
+          data.activeDashboard = 0
+        }
+
+        // Log config info for debugging
+        console.log('✓ Config loaded:', {
+          type: data.type,
+          hasMultiDashboards: !!data.multiDashboards,
+          dashboardCount: data.multiDashboards?.length || 0,
+          activeDashboard: data.activeDashboard,
+          datasetCount: Object.keys(data.datasets || {}).length,
+          vizCount: data.visualizations ? Object.keys(data.visualizations).length : 0
+        })
+
+        setConfig(data)
+      })
+      .catch(err => {
+        console.error('Failed to fetch config:', configUrl, err)
+      })
+  }, [configUrl])
+
+  return config
+}
+
+type DashboardStory = StoryObj<typeof Dashboard>
+
+// Helper function to test dashboard rendering
+const testDashboardRendering = async (canvasElement: HTMLElement, storyName: string) => {
+  await step('Wait for dashboard to render', async () => {
+    await new Promise<void>((resolve, reject) => {
+      const startTime = Date.now()
+      const timeout = 30000 // Longer timeout for external data loading
+
+      const checkDashboard = () => {
+        const dashboardElement = canvasElement.querySelector('.cove-dashboard')
+        const loadingDiv = canvasElement.querySelector('div')
+
+        // Log current state for debugging
+        if (!dashboardElement && loadingDiv?.textContent?.includes('Loading')) {
+          console.log('Still loading config...')
+        }
+
+        if (dashboardElement) {
+          resolve()
+        } else if (Date.now() - startTime > timeout) {
+          reject(new Error(`Timeout: Dashboard element not found after ${timeout}ms`))
+        } else {
+          setTimeout(checkDashboard, 100)
+        }
+      }
+      checkDashboard()
+    })
+  })
+
+  await step('Verify dashboard wrapper is present', async () => {
+    const dashboard = canvasElement.querySelector('.cove-dashboard')
+    expect(dashboard).toBeInTheDocument()
+  })
+
+  await step('Verify at least one visualization rendered', async () => {
+    const coveModules = canvasElement.querySelectorAll('.cdc-open-viz-module')
+    expect(coveModules.length).toBeGreaterThan(0)
+  })
+
+  console.log(` ${storyName} dashboard rendered successfully`)
+}
+
+/**
+ * Explore by Location Dashboard
+ *
+ * Interactive dashboard showing BRFSS prevalence data organized by geographic location.
+ * Users can explore health indicators by state, territory, and metropolitan/micropolitan
+ * statistical areas (MMSA).
+ */
+export const Explore_By_Location: DashboardStory = {
+  render: () => {
+    const config = useConfigWithAbsoluteDataUrl(CONFIG_URLS.exploreByLocation)
+    if (!config) return <div>Loading...</div>
+    return <Dashboard config={config} />
+  },
+  play: async ({ canvasElement }) => {
+    await testDashboardRendering(canvasElement, 'Explore By Location Dashboard')
+  }
+}
+
+/**
+ * Explore by Topic Dashboard
+ *
+ * Interactive dashboard showing BRFSS prevalence data organized by health topics.
+ * Users can explore various health indicators and risk factors across different
+ * categories such as chronic diseases, health behaviors, and preventive practices.
+ */
+export const Explore_By_Topic: DashboardStory = {
+  render: () => {
+    const config = useConfigWithAbsoluteDataUrl(CONFIG_URLS.exploreByTopic)
+    if (!config) return <div>Loading...</div>
+    return <Dashboard config={config} />
+  },
+  play: async ({ canvasElement }) => {
+    await testDashboardRendering(canvasElement, 'Explore By Topic Dashboard')
+  }
+}
+
+/**
+ * All BRFSS Dashboards - Combined Test
+ *
+ * Tests both BRFSS dashboards to ensure they all render correctly together.
+ */
+export const All_BRFSS_Dashboards: StoryObj = {
+  render: () => {
+    const locationConfig = useConfigWithAbsoluteDataUrl(CONFIG_URLS.exploreByLocation)
+    const topicConfig = useConfigWithAbsoluteDataUrl(CONFIG_URLS.exploreByTopic)
+
+    if (!locationConfig || !topicConfig) {
+      return <div>Loading...</div>
+    }
+
+    return (
+      <div className="container-fluid p-4">
+        <h1 className="mb-4">BRFSS Prevalence Data - All Dashboards</h1>
+
+        <section className="mb-5">
+          <h2>Explore by Location</h2>
+          <Dashboard config={locationConfig} />
+        </section>
+
+        <section className="mb-5">
+          <h2>Explore by Topic</h2>
+          <Dashboard config={topicConfig} />
+        </section>
+      </div>
+    )
+  },
+  play: async ({ canvasElement }) => {
+    const canvas = within(canvasElement)
+
+    await step('Wait for all configs to load', async () => {
+      await new Promise<void>(resolve => {
+        const checkLoading = () => {
+          const loadingDiv = canvasElement.querySelector('div:not(.container-fluid)')
+          if (!loadingDiv || !loadingDiv.textContent?.includes('Loading')) {
+            resolve()
+          } else {
+            setTimeout(checkLoading, 100)
+          }
+        }
+        checkLoading()
+      })
+    })
+
+    await step('Wait for visualizations to start rendering', async () => {
+      await new Promise<void>(resolve => setTimeout(resolve, 2000))
+    })
+
+    await step('Wait for both dashboards to render', async () => {
+      await new Promise<void>((resolve, reject) => {
+        const startTime = Date.now()
+        const timeout = 40000
+
+        const checkDashboards = () => {
+          const dashboards = canvasElement.querySelectorAll('.cove-dashboard')
+          if (dashboards.length >= 2) {
+            resolve()
+          } else if (Date.now() - startTime > timeout) {
+            reject(new Error(`Timeout: Only ${dashboards.length}/2 dashboards found after ${timeout}ms`))
+          } else {
+            setTimeout(checkDashboards, 200)
+          }
+        }
+        checkDashboards()
+      })
+    })
+
+    await step('Verify both dashboards are present', async () => {
+      const dashboards = canvasElement.querySelectorAll('.cove-dashboard')
+      expect(dashboards.length).toBe(2)
+    })
+
+    console.log(` All 2 BRFSS dashboards rendered successfully`)
+  }
+}