@contractspec/example.analytics-dashboard 3.7.6 → 3.8.0

package/dist/browser/ui/index.js

@@ -1,276 +1,786 @@
-// src/ui/renderers/analytics.markdown.ts
-var mockDashboards = [
-  {
-    id: "dash-1",
-    name: "Sales Overview",
-    slug: "sales-overview",
-    status: "PUBLISHED",
-    widgetCount: 8,
-    viewCount: 1250,
-    lastViewedAt: "2024-01-16T12:00:00Z"
+// 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."
   },
-  {
-    id: "dash-2",
-    name: "User Engagement",
-    slug: "user-engagement",
-    status: "PUBLISHED",
-    widgetCount: 6,
-    viewCount: 890,
-    lastViewedAt: "2024-01-16T10:00:00Z"
+  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."
   },
-  {
-    id: "dash-3",
-    name: "Product Analytics",
-    slug: "product-analytics",
-    status: "PUBLISHED",
-    widgetCount: 10,
-    viewCount: 560,
-    lastViewedAt: "2024-01-15T14:00:00Z"
+  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."
   },
-  {
-    id: "dash-4",
-    name: "Finance Report",
-    slug: "finance-report",
-    status: "DRAFT",
-    widgetCount: 4,
-    viewCount: 0,
-    lastViewedAt: null
+  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 mockWidgets = [
-  {
-    id: "w-1",
-    dashboardId: "dash-1",
-    name: "Total Revenue",
-    type: "METRIC",
-    value: 125000,
-    change: 12.5
+});
+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."
   },
-  {
-    id: "w-2",
-    dashboardId: "dash-1",
-    name: "Active Users",
-    type: "METRIC",
-    value: 4500,
-    change: 8.2
+  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."
   },
-  {
-    id: "w-3",
-    dashboardId: "dash-1",
-    name: "Revenue Trend",
-    type: "LINE_CHART",
-    dataPoints: 30
+  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."
   },
-  {
-    id: "w-4",
-    dashboardId: "dash-1",
-    name: "Top Products",
-    type: "BAR_CHART",
-    dataPoints: 10
+  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."
   },
-  {
-    id: "w-5",
-    dashboardId: "dash-2",
-    name: "Daily Active Users",
-    type: "LINE_CHART",
-    dataPoints: 30
+  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."
   },
-  {
-    id: "w-6",
-    dashboardId: "dash-2",
-    name: "Session Duration",
-    type: "METRIC",
-    value: 245,
-    change: -3.1
+  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 mockQueries = [
-  {
-    id: "q-1",
-    name: "Monthly Revenue",
-    type: "AGGREGATION",
-    isShared: true,
-    executionCount: 1500
+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 }
+    ]
   },
-  {
-    id: "q-2",
-    name: "User Growth",
-    type: "METRIC",
-    isShared: true,
-    executionCount: 890
+  [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 }
+    ]
   },
-  {
-    id: "q-3",
-    name: "Product Sales",
-    type: "SQL",
-    isShared: false,
-    executionCount: 340
+  [visualizationRefKey(RegionalRevenueVisualization.meta)]: {
+    data: [
+      { region: "North America", revenue: 210000 },
+      { region: "EMEA", revenue: 174000 },
+      { region: "APAC", revenue: 132000 },
+      { region: "LATAM", revenue: 88000 }
+    ]
   },
-  {
-    id: "q-4",
-    name: "Conversion Funnel",
-    type: "AGGREGATION",
-    isShared: true,
-    executionCount: 450
-  }
-];
-function formatNumber(value) {
-  if (value >= 1e6) {
-    return `${(value / 1e6).toFixed(1)}M`;
-  }
-  if (value >= 1000) {
-    return `${(value / 1000).toFixed(1)}K`;
+  [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
+      }
+    ]
   }
-  return value.toString();
+};
+function refOf(spec) {
+  return { key: spec.meta.key, version: spec.meta.version };
 }
-function formatChange(change) {
-  const icon = change >= 0 ? "\uD83D\uDCC8" : "\uD83D\uDCC9";
-  const sign = change >= 0 ? "+" : "";
-  return `${icon} ${sign}${change.toFixed(1)}%`;
+function visualizationRefKey(ref) {
+  return `${ref.key}.v${ref.version}`;
 }
-var analyticsDashboardMarkdownRenderer = {
-  target: "markdown",
-  render: async (desc) => {
-    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];
-    if (!dashboard) {
-      return {
-        mimeType: "text/markdown",
-        body: `# No Dashboards
 
-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 lines = [
-      `# ${dashboard.name}`,
-      "",
-      "> 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("");
-    }
-    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("");
-    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} |`);
-    return {
-      mimeType: "text/markdown",
-      body: lines.join(`
-`)
-    };
-  }
+// 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)
 };
-var dashboardListMarkdownRenderer = {
-  target: "markdown",
-  render: async (desc) => {
-    if (desc.source.type !== "component" || desc.source.componentKey !== "DashboardList") {
-      throw new Error("dashboardListMarkdownRenderer: not DashboardList");
-    }
-    const dashboards = mockDashboards;
-    const lines = [
-      "# Dashboards",
-      "",
-      "> Browse and manage analytics dashboards",
-      "",
-      "| Dashboard | Widgets | Views | Status | Last Viewed |",
-      "|-----------|---------|-------|--------|-------------|"
-    ];
-    for (const dashboard of dashboards) {
-      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");
+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 {
-      mimeType: "text/markdown",
-      body: lines.join(`
-`)
+      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;
   }
-};
-var queryBuilderMarkdownRenderer = {
-  target: "markdown",
-  render: async (desc) => {
-    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",
-      "",
-      "| 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()} |`);
-    }
-    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("");
-    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");
-    return {
-      mimeType: "text/markdown",
-      body: lines.join(`
-`)
-    };
+  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/AnalyticsDashboard.widgets.tsx
+import {
+  ComparisonView,
+  TimelineView,
+  VisualizationCard,
+  VisualizationGrid
+} from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function AnalyticsWidgetBoard({
+  dashboardName,
+  widgets
+}) {
+  if (!widgets.length) {
+    return /* @__PURE__ */ jsxDEV("div", {
+      className: "rounded-lg border border-dashed p-10 text-center text-muted-foreground",
+      children: [
+        'No visualization widgets configured for "',
+        dashboardName,
+        '".'
+      ]
+    }, undefined, true, undefined, this);
   }
+  return /* @__PURE__ */ jsxDEV("div", {
+    children: [
+      /* @__PURE__ */ jsxDEV("h3", {
+        className: "mb-4 font-semibold text-lg",
+        children: [
+          'Widgets in "',
+          dashboardName,
+          '"'
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(VisualizationGrid, {
+        children: widgets.map((widget2) => /* @__PURE__ */ jsxDEV("div", {
+          className: gridSpanClass(widget2.gridWidth),
+          children: renderVisualizationWidget(widget2)
+        }, widget2.id, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function renderVisualizationWidget(widget2) {
+  const footer = /* @__PURE__ */ jsxDEV("span", {
+    className: "text-muted-foreground text-xs",
+    children: [
+      "Position: (",
+      widget2.gridX,
+      ", ",
+      widget2.gridY,
+      ") • ",
+      widget2.gridWidth,
+      "x",
+      widget2.gridHeight
+    ]
+  }, undefined, true, undefined, this);
+  if (widget2.layout === "comparison") {
+    return /* @__PURE__ */ jsxDEV(ComparisonView, {
+      description: widget2.description,
+      items: widget2.bindings.map((binding3) => ({ ...binding3, footer })),
+      title: widget2.name
+    }, undefined, false, undefined, this);
+  }
+  if (widget2.layout === "timeline") {
+    return /* @__PURE__ */ jsxDEV(TimelineView, {
+      description: widget2.description,
+      items: widget2.bindings.map((binding3) => ({ ...binding3, footer })),
+      title: widget2.name
+    }, undefined, false, undefined, this);
+  }
+  const binding2 = widget2.bindings[0];
+  if (!binding2)
+    return null;
+  return /* @__PURE__ */ jsxDEV(VisualizationCard, {
+    data: binding2.data,
+    description: widget2.description ?? binding2.description,
+    footer,
+    height: binding2.height,
+    spec: binding2.spec,
+    title: widget2.name
+  }, undefined, false, undefined, this);
+}
+function gridSpanClass(gridWidth) {
+  if (gridWidth >= 12)
+    return "md:col-span-2 xl:col-span-3";
+  if (gridWidth >= 8)
+    return "xl:col-span-2";
+  if (gridWidth >= 6)
+    return "md:col-span-2";
+  return "";
+}
+
+// src/ui/AnalyticsQueriesTable.tsx
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+var QUERY_TYPE_COLORS = {
+  SQL: "bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400",
+  METRIC: "bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400",
+  AGGREGATION: "bg-indigo-100 text-indigo-700 dark:bg-indigo-900/30 dark:text-indigo-400",
+  CUSTOM: "bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400"
 };
+function AnalyticsQueriesTable({ queries }) {
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: "rounded-lg border border-border",
+    children: /* @__PURE__ */ jsxDEV2("table", {
+      className: "w-full",
+      children: [
+        /* @__PURE__ */ jsxDEV2("thead", {
+          className: "border-border border-b bg-muted/30",
+          children: /* @__PURE__ */ jsxDEV2("tr", {
+            children: [
+              /* @__PURE__ */ jsxDEV2("th", {
+                className: "px-4 py-3 text-left font-medium text-sm",
+                children: "Query"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("th", {
+                className: "px-4 py-3 text-left font-medium text-sm",
+                children: "Type"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("th", {
+                className: "px-4 py-3 text-left font-medium text-sm",
+                children: "Cache TTL"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("th", {
+                className: "px-4 py-3 text-left font-medium text-sm",
+                children: "Shared"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2("tbody", {
+          className: "divide-y divide-border",
+          children: [
+            queries.map((query) => /* @__PURE__ */ jsxDEV2("tr", {
+              className: "hover:bg-muted/50",
+              children: [
+                /* @__PURE__ */ jsxDEV2("td", {
+                  className: "px-4 py-3",
+                  children: [
+                    /* @__PURE__ */ jsxDEV2("div", {
+                      className: "font-medium",
+                      children: query.name
+                    }, undefined, false, undefined, this),
+                    /* @__PURE__ */ jsxDEV2("div", {
+                      className: "text-muted-foreground text-sm",
+                      children: query.description
+                    }, undefined, false, undefined, this)
+                  ]
+                }, undefined, true, undefined, this),
+                /* @__PURE__ */ jsxDEV2("td", {
+                  className: "px-4 py-3",
+                  children: /* @__PURE__ */ jsxDEV2("span", {
+                    className: `inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${QUERY_TYPE_COLORS[query.type] ?? ""}`,
+                    children: query.type
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV2("td", {
+                  className: "px-4 py-3 text-muted-foreground text-sm",
+                  children: [
+                    query.cacheTtlSeconds,
+                    "s"
+                  ]
+                }, undefined, true, undefined, this),
+                /* @__PURE__ */ jsxDEV2("td", {
+                  className: "px-4 py-3",
+                  children: query.isShared ? /* @__PURE__ */ jsxDEV2("span", {
+                    className: "text-green-600 dark:text-green-400",
+                    children: "✓"
+                  }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV2("span", {
+                    className: "text-muted-foreground",
+                    children: "—"
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this)
+              ]
+            }, query.id, true, undefined, this)),
+            queries.length === 0 && /* @__PURE__ */ jsxDEV2("tr", {
+              children: /* @__PURE__ */ jsxDEV2("td", {
+                colSpan: 4,
+                className: "px-4 py-8 text-center text-muted-foreground",
+                children: "No queries saved"
+              }, undefined, false, undefined, this)
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
+}
+
 // src/ui/hooks/useAnalyticsData.ts
-import { useCallback, useEffect, useState } from "react";
 import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+import { useCallback, useEffect, useState } from "react";
 "use client";
 function useAnalyticsData(projectId = "local-project") {
   const { handlers } = useTemplateRuntime();
@@ -296,7 +806,7 @@ function useAnalyticsData(projectId = "local-project") {
         if (first) {
           setSelectedDashboard(first);
           const dashboardWidgets = await analytics.getWidgets(first.id);
-          setWidgets(dashboardWidgets);
+          setWidgets(dashboardWidgets.length > 0 ? dashboardWidgets : createExampleWidgets(first.id));
         }
       }
     } catch (err) {
@@ -311,7 +821,7 @@ function useAnalyticsData(projectId = "local-project") {
   const selectDashboard = useCallback(async (dashboard) => {
     setSelectedDashboard(dashboard);
     const dashboardWidgets = await analytics.getWidgets(dashboard.id);
-    setWidgets(dashboardWidgets);
+    setWidgets(dashboardWidgets.length > 0 ? dashboardWidgets : createExampleWidgets(dashboard.id));
   }, [analytics]);
   const stats = {
     totalDashboards: dashboards.length,
@@ -333,7 +843,6 @@ function useAnalyticsData(projectId = "local-project") {
 }
 
 // src/ui/AnalyticsDashboard.tsx
-import { useState as useState2 } from "react";
 import {
   Button,
   ErrorState,
@@ -341,33 +850,14 @@ import {
   StatCard,
   StatCardGroup
 } from "@contractspec/lib.design-system";
-import { jsxDEV } from "react/jsx-dev-runtime";
+import { useMemo, useState as useState2 } from "react";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
 "use client";
 var STATUS_COLORS = {
   PUBLISHED: "bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400",
   DRAFT: "bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400",
   ARCHIVED: "bg-yellow-100 text-yellow-700 dark:bg-yellow-900/30 dark:text-yellow-400"
 };
-var WIDGET_ICONS = {
-  LINE_CHART: "\uD83D\uDCC8",
-  BAR_CHART: "\uD83D\uDCCA",
-  PIE_CHART: "\uD83E\uDD67",
-  AREA_CHART: "\uD83D\uDCC9",
-  SCATTER_PLOT: "⚬",
-  METRIC: "\uD83D\uDD22",
-  TABLE: "\uD83D\uDCCB",
-  HEATMAP: "\uD83D\uDDFA️",
-  FUNNEL: "⏬",
-  MAP: "\uD83C\uDF0D",
-  TEXT: "\uD83D\uDCDD",
-  EMBED: "\uD83D\uDD17"
-};
-var QUERY_TYPE_COLORS = {
-  SQL: "bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400",
-  METRIC: "bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400",
-  AGGREGATION: "bg-indigo-100 text-indigo-700 dark:bg-indigo-900/30 dark:text-indigo-400",
-  CUSTOM: "bg-gray-100 text-gray-700 dark:bg-gray-900/30 dark:text-gray-400"
-};
 function AnalyticsDashboard() {
   const [activeTab, setActiveTab] = useState2("dashboards");
   const {
@@ -385,33 +875,34 @@ function AnalyticsDashboard() {
     { id: "dashboards", label: "Dashboards", icon: "\uD83D\uDCCA" },
     { id: "queries", label: "Queries", icon: "\uD83D\uDD0D" }
   ];
+  const resolvedWidgets = useMemo(() => widgets.map((widget2) => resolveAnalyticsWidget(widget2)).filter((widget2) => Boolean(widget2)), [widgets]);
   if (loading) {
-    return /* @__PURE__ */ jsxDEV(LoaderBlock, {
+    return /* @__PURE__ */ jsxDEV3(LoaderBlock, {
       label: "Loading Analytics..."
     }, undefined, false, undefined, this);
   }
   if (error) {
-    return /* @__PURE__ */ jsxDEV(ErrorState, {
+    return /* @__PURE__ */ jsxDEV3(ErrorState, {
       title: "Failed to load Analytics",
       description: error.message,
       onRetry: refetch,
       retryLabel: "Retry"
     }, undefined, false, undefined, this);
   }
-  return /* @__PURE__ */ jsxDEV("div", {
+  return /* @__PURE__ */ jsxDEV3("div", {
     className: "space-y-6",
     children: [
-      /* @__PURE__ */ jsxDEV("div", {
+      /* @__PURE__ */ jsxDEV3("div", {
         className: "flex items-center justify-between",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
-            className: "text-2xl font-bold",
+          /* @__PURE__ */ jsxDEV3("h2", {
+            className: "font-bold text-2xl",
             children: "Analytics Dashboard"
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV(Button, {
+          /* @__PURE__ */ jsxDEV3(Button, {
             onClick: () => alert("Create dashboard modal"),
             children: [
-              /* @__PURE__ */ jsxDEV("span", {
+              /* @__PURE__ */ jsxDEV3("span", {
                 className: "mr-2",
                 children: "+"
               }, undefined, false, undefined, this),
@@ -420,55 +911,55 @@ function AnalyticsDashboard() {
           }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV(StatCardGroup, {
+      /* @__PURE__ */ jsxDEV3(StatCardGroup, {
         children: [
-          /* @__PURE__ */ jsxDEV(StatCard, {
+          /* @__PURE__ */ jsxDEV3(StatCard, {
             label: "Dashboards",
             value: stats.totalDashboards,
             hint: `${stats.publishedDashboards} published`
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV(StatCard, {
+          /* @__PURE__ */ jsxDEV3(StatCard, {
             label: "Queries",
             value: stats.totalQueries,
             hint: `${stats.sharedQueries} shared`
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV(StatCard, {
+          /* @__PURE__ */ jsxDEV3(StatCard, {
             label: "Widgets",
             value: widgets.length,
             hint: "on current dashboard"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("nav", {
-        className: "bg-muted flex gap-1 rounded-lg p-1",
+      /* @__PURE__ */ jsxDEV3("nav", {
+        className: "flex gap-1 rounded-lg bg-muted p-1",
         role: "tablist",
-        children: tabs.map((tab) => /* @__PURE__ */ jsxDEV(Button, {
+        children: tabs.map((tab) => /* @__PURE__ */ jsxDEV3(Button, {
           type: "button",
           role: "tab",
           "aria-selected": activeTab === tab.id,
           onClick: () => setActiveTab(tab.id),
-          className: `flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 text-sm font-medium transition-colors ${activeTab === tab.id ? "bg-background text-foreground shadow-sm" : "text-muted-foreground hover:text-foreground"}`,
+          className: `flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 font-medium text-sm transition-colors ${activeTab === tab.id ? "bg-background text-foreground shadow-sm" : "text-muted-foreground hover:text-foreground"}`,
           children: [
-            /* @__PURE__ */ jsxDEV("span", {
+            /* @__PURE__ */ jsxDEV3("span", {
               children: tab.icon
             }, undefined, false, undefined, this),
             tab.label
           ]
         }, tab.id, true, undefined, this))
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      /* @__PURE__ */ jsxDEV3("div", {
         className: "min-h-[400px]",
         role: "tabpanel",
         children: [
-          activeTab === "dashboards" && /* @__PURE__ */ jsxDEV("div", {
+          activeTab === "dashboards" && /* @__PURE__ */ jsxDEV3("div", {
             className: "space-y-6",
             children: [
-              /* @__PURE__ */ jsxDEV("div", {
+              /* @__PURE__ */ jsxDEV3("div", {
                 className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3",
                 children: [
-                  dashboards.map((dashboard) => /* @__PURE__ */ jsxDEV("div", {
+                  dashboards.map((dashboard) => /* @__PURE__ */ jsxDEV3("div", {
                     onClick: () => selectDashboard(dashboard),
-                    className: `border-border bg-card cursor-pointer rounded-lg border p-4 transition-all ${selectedDashboard?.id === dashboard.id ? "ring-primary ring-2" : "hover:bg-muted/50"}`,
+                    className: `cursor-pointer rounded-lg border border-border bg-card p-4 transition-all ${selectedDashboard?.id === dashboard.id ? "ring-2 ring-primary" : "hover:bg-muted/50"}`,
                     role: "button",
                     tabIndex: 0,
                     onKeyDown: (e) => {
@@ -476,33 +967,33 @@ function AnalyticsDashboard() {
                         selectDashboard(dashboard);
                     },
                     children: [
-                      /* @__PURE__ */ jsxDEV("div", {
+                      /* @__PURE__ */ jsxDEV3("div", {
                         className: "mb-2 flex items-center justify-between",
                         children: [
-                          /* @__PURE__ */ jsxDEV("h3", {
+                          /* @__PURE__ */ jsxDEV3("h3", {
                             className: "font-medium",
                             children: dashboard.name
                           }, undefined, false, undefined, this),
-                          /* @__PURE__ */ jsxDEV("span", {
-                            className: `inline-flex rounded-full px-2 py-0.5 text-xs font-medium ${STATUS_COLORS[dashboard.status] ?? ""}`,
+                          /* @__PURE__ */ jsxDEV3("span", {
+                            className: `inline-flex rounded-full px-2 py-0.5 font-medium text-xs ${STATUS_COLORS[dashboard.status] ?? ""}`,
                             children: dashboard.status
                           }, undefined, false, undefined, this)
                         ]
                       }, undefined, true, undefined, this),
-                      /* @__PURE__ */ jsxDEV("p", {
-                        className: "text-muted-foreground mb-3 text-sm",
+                      /* @__PURE__ */ jsxDEV3("p", {
+                        className: "mb-3 text-muted-foreground text-sm",
                         children: dashboard.description
                       }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("div", {
-                        className: "text-muted-foreground flex items-center justify-between text-xs",
+                      /* @__PURE__ */ jsxDEV3("div", {
+                        className: "flex items-center justify-between text-muted-foreground text-xs",
                         children: [
-                          /* @__PURE__ */ jsxDEV("span", {
+                          /* @__PURE__ */ jsxDEV3("span", {
                             children: [
                               "/",
                               dashboard.slug
                             ]
                           }, undefined, true, undefined, this),
-                          dashboard.isPublic && /* @__PURE__ */ jsxDEV("span", {
+                          dashboard.isPublic && /* @__PURE__ */ jsxDEV3("span", {
                             className: "text-green-600 dark:text-green-400",
                             children: "\uD83C\uDF10 Public"
                           }, undefined, false, undefined, this)
@@ -510,149 +1001,20 @@ function AnalyticsDashboard() {
                       }, undefined, true, undefined, this)
                     ]
                   }, dashboard.id, true, undefined, this)),
-                  dashboards.length === 0 && /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground col-span-full flex h-64 items-center justify-center",
+                  dashboards.length === 0 && /* @__PURE__ */ jsxDEV3("div", {
+                    className: "col-span-full flex h-64 items-center justify-center text-muted-foreground",
                     children: "No dashboards created yet"
                   }, undefined, false, undefined, this)
                 ]
               }, undefined, true, undefined, this),
-              selectedDashboard && widgets.length > 0 && /* @__PURE__ */ jsxDEV("div", {
-                children: [
-                  /* @__PURE__ */ jsxDEV("h3", {
-                    className: "mb-4 text-lg font-semibold",
-                    children: [
-                      'Widgets in "',
-                      selectedDashboard.name,
-                      '"'
-                    ]
-                  }, undefined, true, undefined, this),
-                  /* @__PURE__ */ jsxDEV("div", {
-                    className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3",
-                    children: widgets.map((widget) => /* @__PURE__ */ jsxDEV("div", {
-                      className: "border-border bg-card rounded-lg border p-4",
-                      children: [
-                        /* @__PURE__ */ jsxDEV("div", {
-                          className: "mb-2 flex items-center gap-2",
-                          children: [
-                            /* @__PURE__ */ jsxDEV("span", {
-                              className: "text-xl",
-                              children: WIDGET_ICONS[widget.type] ?? "\uD83D\uDCCA"
-                            }, undefined, false, undefined, this),
-                            /* @__PURE__ */ jsxDEV("span", {
-                              className: "font-medium",
-                              children: widget.name
-                            }, undefined, false, undefined, this)
-                          ]
-                        }, undefined, true, undefined, this),
-                        /* @__PURE__ */ jsxDEV("div", {
-                          className: "text-muted-foreground text-sm",
-                          children: widget.type.replace(/_/g, " ")
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("div", {
-                          className: "text-muted-foreground mt-2 text-xs",
-                          children: [
-                            "Position: (",
-                            widget.gridX,
-                            ", ",
-                            widget.gridY,
-                            ") •",
-                            " ",
-                            widget.gridWidth,
-                            "x",
-                            widget.gridHeight
-                          ]
-                        }, undefined, true, undefined, this)
-                      ]
-                    }, widget.id, true, undefined, this))
-                  }, undefined, false, undefined, this)
-                ]
-              }, undefined, true, undefined, this)
+              selectedDashboard ? /* @__PURE__ */ jsxDEV3(AnalyticsWidgetBoard, {
+                dashboardName: selectedDashboard.name,
+                widgets: resolvedWidgets
+              }, undefined, false, undefined, this) : null
             ]
           }, undefined, true, undefined, this),
-          activeTab === "queries" && /* @__PURE__ */ jsxDEV("div", {
-            className: "border-border rounded-lg border",
-            children: /* @__PURE__ */ jsxDEV("table", {
-              className: "w-full",
-              children: [
-                /* @__PURE__ */ jsxDEV("thead", {
-                  className: "border-border bg-muted/30 border-b",
-                  children: /* @__PURE__ */ jsxDEV("tr", {
-                    children: [
-                      /* @__PURE__ */ jsxDEV("th", {
-                        className: "px-4 py-3 text-left text-sm font-medium",
-                        children: "Query"
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("th", {
-                        className: "px-4 py-3 text-left text-sm font-medium",
-                        children: "Type"
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("th", {
-                        className: "px-4 py-3 text-left text-sm font-medium",
-                        children: "Cache TTL"
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("th", {
-                        className: "px-4 py-3 text-left text-sm font-medium",
-                        children: "Shared"
-                      }, undefined, false, undefined, this)
-                    ]
-                  }, undefined, true, undefined, this)
-                }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV("tbody", {
-                  className: "divide-border divide-y",
-                  children: [
-                    queries.map((query) => /* @__PURE__ */ jsxDEV("tr", {
-                      className: "hover:bg-muted/50",
-                      children: [
-                        /* @__PURE__ */ jsxDEV("td", {
-                          className: "px-4 py-3",
-                          children: [
-                            /* @__PURE__ */ jsxDEV("div", {
-                              className: "font-medium",
-                              children: query.name
-                            }, undefined, false, undefined, this),
-                            /* @__PURE__ */ jsxDEV("div", {
-                              className: "text-muted-foreground text-sm",
-                              children: query.description
-                            }, undefined, false, undefined, this)
-                          ]
-                        }, undefined, true, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
-                          className: "px-4 py-3",
-                          children: /* @__PURE__ */ jsxDEV("span", {
-                            className: `inline-flex rounded-full px-2 py-0.5 text-xs font-medium ${QUERY_TYPE_COLORS[query.type] ?? ""}`,
-                            children: query.type
-                          }, undefined, false, undefined, this)
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
-                          className: "text-muted-foreground px-4 py-3 text-sm",
-                          children: [
-                            query.cacheTtlSeconds,
-                            "s"
-                          ]
-                        }, undefined, true, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
-                          className: "px-4 py-3",
-                          children: query.isShared ? /* @__PURE__ */ jsxDEV("span", {
-                            className: "text-green-600 dark:text-green-400",
-                            children: "✓"
-                          }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV("span", {
-                            className: "text-muted-foreground",
-                            children: "—"
-                          }, undefined, false, undefined, this)
-                        }, undefined, false, undefined, this)
-                      ]
-                    }, query.id, true, undefined, this)),
-                    queries.length === 0 && /* @__PURE__ */ jsxDEV("tr", {
-                      children: /* @__PURE__ */ jsxDEV("td", {
-                        colSpan: 4,
-                        className: "text-muted-foreground px-4 py-8 text-center",
-                        children: "No queries saved"
-                      }, undefined, false, undefined, this)
-                    }, undefined, false, undefined, this)
-                  ]
-                }, undefined, true, undefined, this)
-              ]
-            }, undefined, true, undefined, this)
+          activeTab === "queries" && /* @__PURE__ */ jsxDEV3(AnalyticsQueriesTable, {
+            queries
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
@@ -662,6 +1024,168 @@ function AnalyticsDashboard() {
 
 // src/ui/hooks/index.ts
 "use client";
+
+// src/ui/renderers/analytics.markdown.ts
+var mockDashboards = [
+  {
+    id: "dash-1",
+    name: "Sales Overview",
+    slug: "sales-overview",
+    status: "PUBLISHED",
+    widgetCount: 11,
+    viewCount: 1250,
+    lastViewedAt: "2026-03-18T12:00:00Z"
+  },
+  {
+    id: "dash-2",
+    name: "User Engagement",
+    slug: "user-engagement",
+    status: "PUBLISHED",
+    widgetCount: 8,
+    viewCount: 890,
+    lastViewedAt: "2026-03-18T10:00:00Z"
+  }
+];
+var mockQueries = [
+  {
+    id: "q-1",
+    name: "Monthly Revenue",
+    type: "AGGREGATION",
+    isShared: true,
+    executionCount: 1500
+  },
+  {
+    id: "q-2",
+    name: "User Growth",
+    type: "METRIC",
+    isShared: true,
+    executionCount: 890
+  },
+  {
+    id: "q-3",
+    name: "Product Sales",
+    type: "SQL",
+    isShared: false,
+    executionCount: 340
+  },
+  {
+    id: "q-4",
+    name: "Conversion Funnel",
+    type: "AGGREGATION",
+    isShared: true,
+    executionCount: 450
+  }
+];
+function dashboardWidgets(dashboardId) {
+  return createExampleWidgets(dashboardId).map((widget2) => resolveAnalyticsWidget(widget2)).filter((widget2) => Boolean(widget2));
+}
+var analyticsDashboardMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "AnalyticsDashboard") {
+      throw new Error("analyticsDashboardMarkdownRenderer: not AnalyticsDashboard");
+    }
+    const dashboard = mockDashboards[0];
+    if (!dashboard) {
+      return {
+        mimeType: "text/markdown",
+        body: `# No Dashboards
+
+No dashboards available.`
+      };
+    }
+    const widgets = dashboardWidgets(dashboard.id);
+    const metricWidgets = widgets.filter((widget2) => widget2.bindings[0]?.spec.visualization.kind === "metric");
+    const lines = [
+      `# ${dashboard.name}`,
+      "",
+      "> Contract-backed analytics dashboard overview.",
+      "",
+      "## Key Metrics",
+      ""
+    ];
+    for (const widget2 of metricWidgets) {
+      const binding2 = widget2.bindings[0];
+      if (!binding2)
+        continue;
+      lines.push(`- **${widget2.name}** via \`${binding2.spec.meta.key}\``);
+    }
+    lines.push("");
+    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 | ${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(`
+`)
+    };
+  }
+};
+var dashboardListMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "DashboardList") {
+      throw new Error("dashboardListMarkdownRenderer: not DashboardList");
+    }
+    const lines = [
+      "# Dashboards",
+      "",
+      "> Browse and manage analytics dashboards",
+      "",
+      "| Dashboard | Widgets | Views | Status | Last Viewed |",
+      "|-----------|---------|-------|--------|-------------|"
+    ];
+    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} |`);
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+var queryBuilderMarkdownRenderer = {
+  target: "markdown",
+  render: async (desc) => {
+    if (desc.source.type !== "component" || desc.source.componentKey !== "QueryBuilder") {
+      throw new Error("queryBuilderMarkdownRenderer: not QueryBuilder");
+    }
+    const lines = [
+      "# Query Builder",
+      "",
+      "> Create and manage reusable data queries.",
+      "",
+      "| Query | Type | Shared | Executions |",
+      "|-------|------|--------|------------|"
+    ];
+    for (const query of mockQueries) {
+      lines.push(`| ${query.name} | ${query.type} | ${query.isShared ? "\uD83C\uDF10" : "\uD83D\uDD12"} | ${query.executionCount.toLocaleString()} |`);
+    }
+    lines.push("");
+    lines.push("## Visualization Contracts");
+    lines.push("");
+    lines.push("Widgets reference `VisualizationSpec` contracts instead of rendering ad-hoc widget types.");
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
 export {
   useAnalyticsData,
   queryBuilderMarkdownRenderer,