@contractspec/example.analytics-dashboard 3.7.5 → 3.8.0

package/dist/node/ui/renderers/index.js

@@ -1,3 +1,594 @@
+// src/visualizations/specs.breakdown.ts
+import { defineVisualization } from "@contractspec/lib.contracts-spec/visualizations";
+var QUERY_REF = { key: "analytics.query.execute", version: "1.0.0" };
+var META = {
+  version: "1.0.0",
+  domain: "analytics",
+  stability: "experimental",
+  owners: ["@example.analytics-dashboard"],
+  tags: ["analytics", "dashboard", "visualization"]
+};
+var ChannelMixVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "analytics.visualization.channel-mix",
+    title: "Channel Mix",
+    description: "Session distribution across acquisition channels.",
+    goal: "Explain which channels currently drive the largest share of traffic.",
+    context: "Marketing attribution dashboard."
+  },
+  source: { primary: QUERY_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "channel",
+    valueMeasure: "sessions",
+    dimensions: [
+      {
+        key: "channel",
+        label: "Channel",
+        dataPath: "channel",
+        type: "category"
+      }
+    ],
+    measures: [{ key: "sessions", label: "Sessions", dataPath: "sessions" }],
+    table: { caption: "Sessions by acquisition channel." }
+  }
+});
+var EngagementHeatmapVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "analytics.visualization.engagement-heatmap",
+    title: "Engagement Heatmap",
+    description: "Average engagement score by weekday and time band.",
+    goal: "Reveal the highest-engagement time windows for product activity.",
+    context: "Usage analytics dashboard."
+  },
+  source: { primary: QUERY_REF, resultPath: "data" },
+  visualization: {
+    kind: "heatmap",
+    xDimension: "timeBand",
+    yDimension: "weekday",
+    valueMeasure: "engagementScore",
+    dimensions: [
+      {
+        key: "timeBand",
+        label: "Time Band",
+        dataPath: "timeBand",
+        type: "category"
+      },
+      {
+        key: "weekday",
+        label: "Weekday",
+        dataPath: "weekday",
+        type: "category"
+      }
+    ],
+    measures: [
+      {
+        key: "engagementScore",
+        label: "Engagement",
+        dataPath: "engagementScore"
+      }
+    ],
+    table: { caption: "Engagement score by weekday and time band." }
+  }
+});
+var ConversionFunnelVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "analytics.visualization.conversion-funnel",
+    title: "Conversion Funnel",
+    description: "Progression through the main acquisition funnel.",
+    goal: "Show where the product is losing the largest share of prospects.",
+    context: "Growth dashboard."
+  },
+  source: { primary: QUERY_REF, resultPath: "data" },
+  visualization: {
+    kind: "funnel",
+    nameDimension: "stage",
+    valueMeasure: "users",
+    sort: "descending",
+    dimensions: [
+      { key: "stage", label: "Stage", dataPath: "stage", type: "category" }
+    ],
+    measures: [{ key: "users", label: "Users", dataPath: "users" }],
+    table: { caption: "Users per conversion stage." }
+  }
+});
+var AccountCoverageGeoVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "analytics.visualization.account-coverage-geo",
+    title: "Account Coverage",
+    description: "High-value accounts plotted on a slippy-map surface.",
+    goal: "Locate where active commercial concentration is strongest.",
+    context: "Territory coverage dashboard."
+  },
+  source: { primary: QUERY_REF, resultPath: "data" },
+  visualization: {
+    kind: "geo",
+    mode: "slippy-map",
+    variant: "scatter",
+    nameDimension: "city",
+    latitudeDimension: "latitude",
+    longitudeDimension: "longitude",
+    valueMeasure: "accounts",
+    dimensions: [
+      { key: "city", label: "City", dataPath: "city", type: "category" },
+      {
+        key: "latitude",
+        label: "Latitude",
+        dataPath: "latitude",
+        type: "latitude"
+      },
+      {
+        key: "longitude",
+        label: "Longitude",
+        dataPath: "longitude",
+        type: "longitude"
+      }
+    ],
+    measures: [{ key: "accounts", label: "Accounts", dataPath: "accounts" }],
+    table: { caption: "Account concentration by city." }
+  }
+});
+
+// src/visualizations/specs.performance.ts
+import { defineVisualization as defineVisualization2 } from "@contractspec/lib.contracts-spec/visualizations";
+var QUERY_REF2 = { key: "analytics.query.execute", version: "1.0.0" };
+var META2 = {
+  version: "1.0.0",
+  domain: "analytics",
+  stability: "experimental",
+  owners: ["@example.analytics-dashboard"],
+  tags: ["analytics", "dashboard", "visualization"]
+};
+var RevenueMetricVisualization = defineVisualization2({
+  meta: {
+    ...META2,
+    key: "analytics.visualization.revenue-metric",
+    title: "Revenue Snapshot",
+    description: "Current recurring revenue with prior-period comparison.",
+    goal: "Highlight the headline commercial metric for the dashboard.",
+    context: "Executive revenue overview."
+  },
+  source: { primary: QUERY_REF2, resultPath: "data" },
+  visualization: {
+    kind: "metric",
+    measure: "totalRevenue",
+    comparisonMeasure: "priorRevenue",
+    dimensions: [
+      { key: "period", label: "Period", dataPath: "period", type: "time" }
+    ],
+    measures: [
+      {
+        key: "totalRevenue",
+        label: "Revenue",
+        dataPath: "totalRevenue",
+        format: "currency"
+      },
+      {
+        key: "priorRevenue",
+        label: "Prior Revenue",
+        dataPath: "priorRevenue",
+        format: "currency"
+      }
+    ],
+    sparkline: { dimension: "period", measure: "totalRevenue" },
+    table: { caption: "Revenue trend and prior period values." }
+  }
+});
+var RevenueTrendVisualization = defineVisualization2({
+  meta: {
+    ...META2,
+    key: "analytics.visualization.revenue-trend",
+    title: "Revenue Trend",
+    description: "Monthly revenue progression for the current quarter.",
+    goal: "Track whether revenue growth is accelerating or stalling.",
+    context: "Quarterly commercial dashboard."
+  },
+  source: { primary: QUERY_REF2, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "date",
+    yMeasures: ["revenue"],
+    dimensions: [
+      { key: "date", label: "Month", dataPath: "date", type: "time" }
+    ],
+    measures: [
+      {
+        key: "revenue",
+        label: "Revenue",
+        dataPath: "revenue",
+        format: "currency",
+        color: "#0f766e"
+      }
+    ],
+    thresholds: [
+      { key: "target", value: 140000, label: "Target", color: "#dc2626" }
+    ],
+    table: { caption: "Monthly revenue values." }
+  }
+});
+var RegionalRevenueVisualization = defineVisualization2({
+  meta: {
+    ...META2,
+    key: "analytics.visualization.regional-revenue",
+    title: "Regional Revenue",
+    description: "Revenue split by sales territory.",
+    goal: "Compare the strongest and weakest performing territories.",
+    context: "Territory planning and commercial comparison."
+  },
+  source: { primary: QUERY_REF2, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "region",
+    yMeasures: ["revenue"],
+    dimensions: [
+      { key: "region", label: "Region", dataPath: "region", type: "category" }
+    ],
+    measures: [
+      {
+        key: "revenue",
+        label: "Revenue",
+        dataPath: "revenue",
+        format: "currency",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Revenue by region." }
+  }
+});
+var RetentionAreaVisualization = defineVisualization2({
+  meta: {
+    ...META2,
+    key: "analytics.visualization.retention-area",
+    title: "Retention Curve",
+    description: "Weekly retention progression across the active cohort.",
+    goal: "Show whether user retention remains above the desired floor.",
+    context: "Product health dashboard."
+  },
+  source: { primary: QUERY_REF2, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "area",
+    xDimension: "week",
+    yMeasures: ["retentionRate"],
+    dimensions: [
+      { key: "week", label: "Week", dataPath: "week", type: "category" }
+    ],
+    measures: [
+      {
+        key: "retentionRate",
+        label: "Retention",
+        dataPath: "retentionRate",
+        format: "percentage",
+        color: "#16a34a"
+      }
+    ],
+    thresholds: [
+      { key: "floor", value: 0.5, label: "Floor", color: "#f59e0b" }
+    ],
+    table: { caption: "Weekly retention rate." }
+  }
+});
+var PipelineScatterVisualization = defineVisualization2({
+  meta: {
+    ...META2,
+    key: "analytics.visualization.pipeline-scatter",
+    title: "Pipeline Velocity",
+    description: "Deal-cycle length against win rate for active accounts.",
+    goal: "Spot outliers where the sales cycle is long but conversion remains weak.",
+    context: "Commercial operations dashboard."
+  },
+  source: { primary: QUERY_REF2, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "scatter",
+    xDimension: "cycleDays",
+    yMeasures: ["winRate"],
+    dimensions: [
+      {
+        key: "cycleDays",
+        label: "Cycle Days",
+        dataPath: "cycleDays",
+        type: "number"
+      }
+    ],
+    measures: [
+      {
+        key: "winRate",
+        label: "Win Rate",
+        dataPath: "winRate",
+        format: "percentage",
+        color: "#7c3aed"
+      },
+      {
+        key: "arr",
+        label: "ARR",
+        dataPath: "arr",
+        format: "currency"
+      }
+    ],
+    series: [
+      {
+        key: "pipeline",
+        label: "Accounts",
+        measure: "winRate",
+        type: "scatter",
+        color: "#7c3aed"
+      }
+    ],
+    table: { caption: "Sales cycle and win rate per account." }
+  }
+});
+
+// src/visualizations/catalog.ts
+import { VisualizationRegistry } from "@contractspec/lib.contracts-spec/visualizations";
+var AnalyticsVisualizationSpecs = [
+  RevenueMetricVisualization,
+  RevenueTrendVisualization,
+  RegionalRevenueVisualization,
+  RetentionAreaVisualization,
+  PipelineScatterVisualization,
+  ChannelMixVisualization,
+  EngagementHeatmapVisualization,
+  ConversionFunnelVisualization,
+  AccountCoverageGeoVisualization
+];
+var AnalyticsVisualizationRegistry = new VisualizationRegistry([
+  ...AnalyticsVisualizationSpecs
+]);
+var AnalyticsVisualizationRefs = AnalyticsVisualizationSpecs.map((spec) => refOf(spec));
+var AnalyticsVisualizationSpecMap = new Map(AnalyticsVisualizationSpecs.map((spec) => [
+  visualizationRefKey(spec.meta),
+  spec
+]));
+var AnalyticsVisualizationSampleData = {
+  [visualizationRefKey(RevenueMetricVisualization.meta)]: {
+    data: [
+      { period: "2025-11-01", totalRevenue: 112000, priorRevenue: 103000 },
+      { period: "2025-12-01", totalRevenue: 119000, priorRevenue: 110000 },
+      { period: "2026-01-01", totalRevenue: 126500, priorRevenue: 116000 },
+      { period: "2026-02-01", totalRevenue: 133000, priorRevenue: 124000 },
+      { period: "2026-03-01", totalRevenue: 145500, priorRevenue: 133000 }
+    ]
+  },
+  [visualizationRefKey(RevenueTrendVisualization.meta)]: {
+    data: [
+      { date: "2025-11-01", revenue: 112000 },
+      { date: "2025-12-01", revenue: 119000 },
+      { date: "2026-01-01", revenue: 126500 },
+      { date: "2026-02-01", revenue: 133000 },
+      { date: "2026-03-01", revenue: 145500 }
+    ]
+  },
+  [visualizationRefKey(RegionalRevenueVisualization.meta)]: {
+    data: [
+      { region: "North America", revenue: 210000 },
+      { region: "EMEA", revenue: 174000 },
+      { region: "APAC", revenue: 132000 },
+      { region: "LATAM", revenue: 88000 }
+    ]
+  },
+  [visualizationRefKey(RetentionAreaVisualization.meta)]: {
+    data: [
+      { week: "Week 1", retentionRate: 0.71 },
+      { week: "Week 2", retentionRate: 0.66 },
+      { week: "Week 3", retentionRate: 0.62 },
+      { week: "Week 4", retentionRate: 0.58 },
+      { week: "Week 5", retentionRate: 0.55 },
+      { week: "Week 6", retentionRate: 0.53 }
+    ]
+  },
+  [visualizationRefKey(PipelineScatterVisualization.meta)]: {
+    data: [
+      { cycleDays: 18, winRate: 0.31, arr: 82000 },
+      { cycleDays: 26, winRate: 0.44, arr: 65000 },
+      { cycleDays: 33, winRate: 0.27, arr: 91000 },
+      { cycleDays: 14, winRate: 0.56, arr: 47000 },
+      { cycleDays: 21, winRate: 0.48, arr: 59000 },
+      { cycleDays: 39, winRate: 0.22, arr: 114000 }
+    ]
+  },
+  [visualizationRefKey(ChannelMixVisualization.meta)]: {
+    data: [
+      { channel: "Direct", sessions: 4200 },
+      { channel: "Organic Search", sessions: 3600 },
+      { channel: "Paid Search", sessions: 2100 },
+      { channel: "Partner", sessions: 1400 },
+      { channel: "Referral", sessions: 900 }
+    ]
+  },
+  [visualizationRefKey(EngagementHeatmapVisualization.meta)]: {
+    data: [
+      { weekday: "Mon", timeBand: "09:00", engagementScore: 74 },
+      { weekday: "Mon", timeBand: "13:00", engagementScore: 82 },
+      { weekday: "Tue", timeBand: "09:00", engagementScore: 69 },
+      { weekday: "Tue", timeBand: "13:00", engagementScore: 88 },
+      { weekday: "Wed", timeBand: "09:00", engagementScore: 77 },
+      { weekday: "Wed", timeBand: "13:00", engagementScore: 91 },
+      { weekday: "Thu", timeBand: "09:00", engagementScore: 72 },
+      { weekday: "Thu", timeBand: "13:00", engagementScore: 86 },
+      { weekday: "Fri", timeBand: "09:00", engagementScore: 65 },
+      { weekday: "Fri", timeBand: "13:00", engagementScore: 79 }
+    ]
+  },
+  [visualizationRefKey(ConversionFunnelVisualization.meta)]: {
+    data: [
+      { stage: "Visited Site", users: 12000 },
+      { stage: "Started Trial", users: 4200 },
+      { stage: "Activated Workspace", users: 2400 },
+      { stage: "Requested Demo", users: 980 },
+      { stage: "Closed Won", users: 310 }
+    ]
+  },
+  [visualizationRefKey(AccountCoverageGeoVisualization.meta)]: {
+    data: [
+      { city: "Paris", latitude: 48.8566, longitude: 2.3522, accounts: 48 },
+      { city: "London", latitude: 51.5072, longitude: -0.1276, accounts: 62 },
+      { city: "New York", latitude: 40.7128, longitude: -74.006, accounts: 71 },
+      { city: "Toronto", latitude: 43.6532, longitude: -79.3832, accounts: 36 },
+      {
+        city: "Singapore",
+        latitude: 1.3521,
+        longitude: 103.8198,
+        accounts: 29
+      }
+    ]
+  }
+};
+function refOf(spec) {
+  return { key: spec.meta.key, version: spec.meta.version };
+}
+function visualizationRefKey(ref) {
+  return `${ref.key}.v${ref.version}`;
+}
+
+// src/visualizations/widgets.ts
+var LEGACY_VISUALIZATION_REFS = {
+  METRIC: refOf(RevenueMetricVisualization),
+  LINE_CHART: refOf(RevenueTrendVisualization),
+  BAR_CHART: refOf(RegionalRevenueVisualization),
+  AREA_CHART: refOf(RetentionAreaVisualization),
+  SCATTER_PLOT: refOf(PipelineScatterVisualization),
+  PIE_CHART: refOf(ChannelMixVisualization),
+  HEATMAP: refOf(EngagementHeatmapVisualization),
+  FUNNEL: refOf(ConversionFunnelVisualization),
+  MAP: refOf(AccountCoverageGeoVisualization)
+};
+function createExampleWidgets(dashboardId) {
+  return [
+    widget(dashboardId, "widget_revenue_metric", "Revenue Snapshot", "METRIC", 0, 0, 4, 2, {
+      layout: "single",
+      bindings: [binding(RevenueMetricVisualization, 200)]
+    }),
+    widget(dashboardId, "widget_revenue_trend", "Revenue Trend", "LINE_CHART", 4, 0, 8, 4, {
+      layout: "single",
+      bindings: [binding(RevenueTrendVisualization)]
+    }),
+    widget(dashboardId, "widget_regional_revenue", "Regional Revenue", "BAR_CHART", 0, 2, 6, 4, {
+      layout: "single",
+      bindings: [binding(RegionalRevenueVisualization)]
+    }),
+    widget(dashboardId, "widget_channel_mix", "Channel Mix", "PIE_CHART", 6, 2, 6, 4, {
+      layout: "single",
+      bindings: [binding(ChannelMixVisualization)]
+    }),
+    widget(dashboardId, "widget_retention", "Retention Curve", "AREA_CHART", 0, 6, 6, 4, {
+      layout: "single",
+      bindings: [binding(RetentionAreaVisualization)]
+    }),
+    widget(dashboardId, "widget_pipeline", "Pipeline Velocity", "SCATTER_PLOT", 6, 6, 6, 4, {
+      layout: "single",
+      bindings: [binding(PipelineScatterVisualization)]
+    }),
+    widget(dashboardId, "widget_heatmap", "Engagement Heatmap", "HEATMAP", 0, 10, 8, 4, {
+      layout: "single",
+      bindings: [binding(EngagementHeatmapVisualization)]
+    }),
+    widget(dashboardId, "widget_funnel", "Conversion Funnel", "FUNNEL", 8, 10, 4, 4, {
+      layout: "single",
+      bindings: [binding(ConversionFunnelVisualization)]
+    }),
+    widget(dashboardId, "widget_geo", "Account Coverage", "MAP", 0, 14, 12, 5, {
+      layout: "single",
+      bindings: [binding(AccountCoverageGeoVisualization, 360)]
+    }),
+    widget(dashboardId, "widget_comparison", "Commercial Comparison", "EMBED", 0, 19, 12, 6, {
+      layout: "comparison",
+      description: "Compare regional distribution, channel balance, and funnel shape.",
+      bindings: [
+        binding(RegionalRevenueVisualization, 240),
+        binding(ChannelMixVisualization, 240),
+        binding(ConversionFunnelVisualization, 240)
+      ]
+    }),
+    widget(dashboardId, "widget_timeline", "Growth Timeline", "EMBED", 0, 25, 12, 6, {
+      layout: "timeline",
+      description: "Track revenue and retention over the same reporting cadence.",
+      bindings: [
+        binding(RevenueTrendVisualization, 220),
+        binding(RetentionAreaVisualization, 220)
+      ]
+    })
+  ];
+}
+function resolveAnalyticsWidget(widget) {
+  const config = parseWidgetConfig(widget);
+  const bindings = config.bindings.map((binding) => {
+    const spec = AnalyticsVisualizationSpecMap.get(visualizationRefKey(binding.ref));
+    if (!spec)
+      return null;
+    return {
+      key: `${widget.id}:${visualizationRefKey(binding.ref)}`,
+      spec,
+      data: binding.data,
+      title: binding.title ?? spec.meta.title,
+      description: binding.description ?? spec.meta.description,
+      height: binding.height
+    };
+  }).filter((binding) => Boolean(binding));
+  if (!bindings.length)
+    return null;
+  return {
+    id: widget.id,
+    name: widget.name,
+    description: config.description,
+    layout: config.layout,
+    gridX: widget.gridX,
+    gridY: widget.gridY,
+    gridWidth: widget.gridWidth,
+    gridHeight: widget.gridHeight,
+    bindings
+  };
+}
+function parseWidgetConfig(widget) {
+  if (isAnalyticsWidgetConfig(widget.config)) {
+    return widget.config;
+  }
+  const legacyRef = LEGACY_VISUALIZATION_REFS[widget.type];
+  return legacyRef ? {
+    layout: "single",
+    bindings: [
+      {
+        ref: legacyRef,
+        data: AnalyticsVisualizationSampleData[visualizationRefKey(legacyRef)]
+      }
+    ]
+  } : { layout: "single", bindings: [] };
+}
+function binding(spec, height = 280) {
+  return {
+    ref: refOf(spec),
+    data: AnalyticsVisualizationSampleData[visualizationRefKey(spec.meta)],
+    height
+  };
+}
+function widget(dashboardId, id, name, type, gridX, gridY, gridWidth, gridHeight, config) {
+  const now = new Date;
+  return {
+    id,
+    dashboardId,
+    name,
+    type,
+    gridX,
+    gridY,
+    gridWidth,
+    gridHeight,
+    config,
+    createdAt: now,
+    updatedAt: now
+  };
+}
+function isAnalyticsWidgetConfig(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const candidate = value;
+  return (candidate.layout === "single" || candidate.layout === "comparison" || candidate.layout === "timeline") && Array.isArray(candidate.bindings);
+}
 // src/ui/renderers/analytics.markdown.ts
 var mockDashboards = [
   {
@@ -5,83 +596,18 @@ var mockDashboards = [
     name: "Sales Overview",
     slug: "sales-overview",
     status: "PUBLISHED",
-    widgetCount: 8,
+    widgetCount: 11,
     viewCount: 1250,
-    lastViewedAt: "2024-01-16T12:00:00Z"
+    lastViewedAt: "2026-03-18T12:00:00Z"
   },
   {
     id: "dash-2",
     name: "User Engagement",
     slug: "user-engagement",
     status: "PUBLISHED",
-    widgetCount: 6,
+    widgetCount: 8,
     viewCount: 890,
-    lastViewedAt: "2024-01-16T10:00:00Z"
-  },
-  {
-    id: "dash-3",
-    name: "Product Analytics",
-    slug: "product-analytics",
-    status: "PUBLISHED",
-    widgetCount: 10,
-    viewCount: 560,
-    lastViewedAt: "2024-01-15T14:00:00Z"
-  },
-  {
-    id: "dash-4",
-    name: "Finance Report",
-    slug: "finance-report",
-    status: "DRAFT",
-    widgetCount: 4,
-    viewCount: 0,
-    lastViewedAt: null
-  }
-];
-var mockWidgets = [
-  {
-    id: "w-1",
-    dashboardId: "dash-1",
-    name: "Total Revenue",
-    type: "METRIC",
-    value: 125000,
-    change: 12.5
-  },
-  {
-    id: "w-2",
-    dashboardId: "dash-1",
-    name: "Active Users",
-    type: "METRIC",
-    value: 4500,
-    change: 8.2
-  },
-  {
-    id: "w-3",
-    dashboardId: "dash-1",
-    name: "Revenue Trend",
-    type: "LINE_CHART",
-    dataPoints: 30
-  },
-  {
-    id: "w-4",
-    dashboardId: "dash-1",
-    name: "Top Products",
-    type: "BAR_CHART",
-    dataPoints: 10
-  },
-  {
-    id: "w-5",
-    dashboardId: "dash-2",
-    name: "Daily Active Users",
-    type: "LINE_CHART",
-    dataPoints: 30
-  },
-  {
-    id: "w-6",
-    dashboardId: "dash-2",
-    name: "Session Duration",
-    type: "METRIC",
-    value: 245,
-    change: -3.1
+    lastViewedAt: "2026-03-18T10:00:00Z"
   }
 ];
 var mockQueries = [
@@ -114,19 +640,8 @@ var mockQueries = [
     executionCount: 450
   }
 ];
-function formatNumber(value) {
-  if (value >= 1e6) {
-    return `${(value / 1e6).toFixed(1)}M`;
-  }
-  if (value >= 1000) {
-    return `${(value / 1000).toFixed(1)}K`;
-  }
-  return value.toString();
-}
-function formatChange(change) {
-  const icon = change >= 0 ? "\uD83D\uDCC8" : "\uD83D\uDCC9";
-  const sign = change >= 0 ? "+" : "";
-  return `${icon} ${sign}${change.toFixed(1)}%`;
+function dashboardWidgets(dashboardId) {
+  return createExampleWidgets(dashboardId).map((widget2) => resolveAnalyticsWidget(widget2)).filter((widget2) => Boolean(widget2));
 }
 var analyticsDashboardMarkdownRenderer = {
   target: "markdown",
@@ -134,10 +649,7 @@ var analyticsDashboardMarkdownRenderer = {
     if (desc.source.type !== "component" || desc.source.componentKey !== "AnalyticsDashboard") {
       throw new Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");
     }
-    const dashboards = mockDashboards;
-    const widgets = mockWidgets;
-    const queries = mockQueries;
-    const dashboard = dashboards[0];
+    const dashboard = mockDashboards[0];
     if (!dashboard) {
       return {
         mimeType: "text/markdown",
@@ -146,41 +658,37 @@ var analyticsDashboardMarkdownRenderer = {
 No dashboards available.`
       };
     }
-    const dashboardWidgets = widgets.filter((w) => w.dashboardId === dashboard.id);
-    const publishedDashboards = dashboards.filter((d) => d.status === "PUBLISHED");
-    const totalViews = dashboards.reduce((sum, d) => sum + d.viewCount, 0);
-    const sharedQueries = queries.filter((q) => q.isShared);
+    const widgets = dashboardWidgets(dashboard.id);
+    const metricWidgets = widgets.filter((widget2) => widget2.bindings[0]?.spec.visualization.kind === "metric");
     const lines = [
       `# ${dashboard.name}`,
       "",
-      "> Analytics dashboard overview",
+      "> Contract-backed analytics dashboard overview.",
       "",
       "## Key Metrics",
       ""
     ];
-    const metricWidgets = dashboardWidgets.filter((w) => w.type === "METRIC");
-    for (const widget of metricWidgets) {
-      const w = widget;
-      lines.push(`### ${w.name}`);
-      lines.push(`**${formatNumber(w.value)}** ${formatChange(w.change)}`);
-      lines.push("");
+    for (const widget2 of metricWidgets) {
+      const binding2 = widget2.bindings[0];
+      if (!binding2)
+        continue;
+      lines.push(`- **${widget2.name}** via \`${binding2.spec.meta.key}\``);
     }
-    lines.push("## Visualizations");
     lines.push("");
-    const chartWidgets = dashboardWidgets.filter((w) => w.type !== "METRIC");
-    for (const widget of chartWidgets) {
-      const w = widget;
-      lines.push(`- **${w.name}** (${w.type.replace("_", " ")}) - ${w.dataPoints} data points`);
+    lines.push("## Visual Blocks");
+    lines.push("");
+    for (const widget2 of widgets) {
+      const kinds = widget2.bindings.map((binding2) => binding2.spec.visualization.kind).join(", ");
+      lines.push(`- **${widget2.name}** (${widget2.layout}) → ${kinds}`);
     }
     lines.push("");
     lines.push("## Dashboard Stats");
     lines.push("");
     lines.push("| Metric | Value |");
     lines.push("|--------|-------|");
-    lines.push(`| Total Dashboards | ${dashboards.length} |`);
-    lines.push(`| Published | ${publishedDashboards.length} |`);
-    lines.push(`| Total Views | ${totalViews.toLocaleString()} |`);
-    lines.push(`| Shared Queries | ${sharedQueries.length} |`);
+    lines.push(`| Total Dashboards | ${mockDashboards.length} |`);
+    lines.push(`| Published | ${mockDashboards.filter((item) => item.status === "PUBLISHED").length} |`);
+    lines.push(`| Shared Queries | ${mockQueries.filter((query) => query.isShared).length} |`);
     return {
       mimeType: "text/markdown",
       body: lines.join(`
@@ -194,7 +702,6 @@ var dashboardListMarkdownRenderer = {
     if (desc.source.type !== "component" || desc.source.componentKey !== "DashboardList") {
       throw new Error("dashboardListMarkdownRenderer: not DashboardList");
     }
-    const dashboards = mockDashboards;
     const lines = [
       "# Dashboards",
       "",
@@ -203,17 +710,11 @@ var dashboardListMarkdownRenderer = {
       "| Dashboard | Widgets | Views | Status | Last Viewed |",
       "|-----------|---------|-------|--------|-------------|"
     ];
-    for (const dashboard of dashboards) {
+    for (const dashboard of mockDashboards) {
       const lastViewed = dashboard.lastViewedAt ? new Date(dashboard.lastViewedAt).toLocaleDateString() : "Never";
       const statusIcon = dashboard.status === "PUBLISHED" ? "\uD83D\uDFE2" : "⚫";
       lines.push(`| [${dashboard.name}](/dashboards/${dashboard.slug}) | ${dashboard.widgetCount} | ${dashboard.viewCount.toLocaleString()} | ${statusIcon} ${dashboard.status} | ${lastViewed} |`);
     }
-    lines.push("");
-    lines.push("## Quick Actions");
-    lines.push("");
-    lines.push("- **Create Dashboard** - Start with a blank canvas");
-    lines.push("- **Import Template** - Use a pre-built template");
-    lines.push("- **Clone Dashboard** - Duplicate an existing dashboard");
     return {
       mimeType: "text/markdown",
       body: lines.join(`
@@ -227,40 +728,21 @@ var queryBuilderMarkdownRenderer = {
     if (desc.source.type !== "component" || desc.source.componentKey !== "QueryBuilder") {
       throw new Error("queryBuilderMarkdownRenderer: not QueryBuilder");
     }
-    const queries = mockQueries;
     const lines = [
       "# Query Builder",
       "",
-      "> Create and manage data queries",
-      "",
-      "## Saved Queries",
+      "> Create and manage reusable data queries.",
       "",
       "| Query | Type | Shared | Executions |",
       "|-------|------|--------|------------|"
     ];
-    for (const query of queries) {
-      const sharedIcon = query.isShared ? "\uD83C\uDF10" : "\uD83D\uDD12";
-      lines.push(`| ${query.name} | ${query.type} | ${sharedIcon} | ${query.executionCount.toLocaleString()} |`);
+    for (const query of mockQueries) {
+      lines.push(`| ${query.name} | ${query.type} | ${query.isShared ? "\uD83C\uDF10" : "\uD83D\uDD12"} | ${query.executionCount.toLocaleString()} |`);
     }
     lines.push("");
-    lines.push("## Query Types");
-    lines.push("");
-    lines.push("### METRIC");
-    lines.push("Query usage metrics from the metering system.");
-    lines.push("");
-    lines.push("### AGGREGATION");
-    lines.push("Build aggregations with measures and dimensions without writing SQL.");
-    lines.push("");
-    lines.push("### SQL");
-    lines.push("Write custom SQL queries for advanced analysis.");
-    lines.push("");
-    lines.push("## Features");
+    lines.push("## Visualization Contracts");
     lines.push("");
-    lines.push("- Visual query builder");
-    lines.push("- Auto-complete for fields and functions");
-    lines.push("- Query validation and optimization");
-    lines.push("- Result caching");
-    lines.push("- Query sharing and collaboration");
+    lines.push("Widgets reference `VisualizationSpec` contracts instead of rendering ad-hoc widget types.");
     return {
       mimeType: "text/markdown",
       body: lines.join(`