@contractspec/example.analytics-dashboard 3.7.6 → 3.8.0

package/dist/browser/visualizations/specs.breakdown.js

@@ -0,0 +1,140 @@
+// 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." }
+  }
+});
+export {
+  EngagementHeatmapVisualization,
+  ConversionFunnelVisualization,
+  ChannelMixVisualization,
+  AccountCoverageGeoVisualization
+};

package/dist/browser/visualizations/specs.performance.js

@@ -0,0 +1,198 @@
+// src/visualizations/specs.performance.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 RevenueMetricVisualization = defineVisualization({
+  meta: {
+    ...META,
+    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_REF, 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 = defineVisualization({
+  meta: {
+    ...META,
+    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_REF, 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 = defineVisualization({
+  meta: {
+    ...META,
+    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_REF, 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 = defineVisualization({
+  meta: {
+    ...META,
+    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_REF, 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 = defineVisualization({
+  meta: {
+    ...META,
+    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_REF, 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." }
+  }
+});
+export {
+  RevenueTrendVisualization,
+  RevenueMetricVisualization,
+  RetentionAreaVisualization,
+  RegionalRevenueVisualization,
+  PipelineScatterVisualization
+};