docs: update pipeline dashboard comparison chart examples and tests

Author: os-zhuang

examples/app-crm/src/dashboards/pipeline.dashboard.ts

@@ -13,12 +13,14 @@ import type { Dashboard } from '@objectstack/spec/ui';
  *   labelled "vs last quarter".
  * - **Avg Deal Size YoY** — metric with `compareTo: 'previousYear'` to
  *   compare against the same window one year prior.
- * - **Pipeline Trend (90d)** — line chart with a sliding
- *   `compareTo: { offset: '90d' }` overlay, rendered as a dashed muted
- *   series on top of the current 90-day trend.
- * - **Opportunities by Stage** / **Pipeline by Industry** — bar / pie
- *   examples without `compareTo` (pie / donut / funnel ignore overlays
- *   even if set).
+ * - **Pipeline Trend (12 months)** — line chart with
+ *   `categoryGranularity: 'month'` bucketing and a `compareTo: 'previousYear'`
+ *   overlay, rendered as a dashed muted series on top of the current
+ *   12-month trend.
+ * - **Opportunities by Stage** — bar chart with
+ *   `compareTo: 'previousPeriod'` to overlay the prior quarter.
+ * - **Pipeline by Industry** — pie chart without `compareTo`
+ *   (pie / donut / funnel ignore overlays even if set).
  */
 export const PipelineDashboard: Dashboard = {
   name: 'pipeline_dashboard',

examples/app-crm/test/smoke.test.ts

@@ -60,18 +60,24 @@ describe('Pipeline dashboard', () => {
     expect(w.filter.close_date.$lte).toBe('{current_year_end}');
   });
 
-  it('uses a sliding `{ offset }` compareTo on the trend chart', () => {
+  it('uses a YoY `previousYear` compareTo on the trend chart', () => {
     const w: any = byId.get('pipeline_trend_90d');
-    expect(w.compareTo).toEqual({ offset: '90d' });
+    expect(w.compareTo).toBe('previousYear');
     expect(w.type).toBe('line');
+    expect(w.categoryGranularity).toBe('month');
   });
 
-  it('omits compareTo on widgets that do not need it (pie, plain bar, total)', () => {
+  it('omits compareTo on widgets that do not need it (pie, total)', () => {
     expect((byId.get('total_pipeline') as any).compareTo).toBeUndefined();
-    expect((byId.get('opportunities_by_stage') as any).compareTo).toBeUndefined();
     expect((byId.get('pipeline_by_industry') as any).compareTo).toBeUndefined();
   });
 
+  it('uses `compareTo: previousPeriod` on the Opportunities by Stage bar chart', () => {
+    const w: any = byId.get('opportunities_by_stage');
+    expect(w.compareTo).toBe('previousPeriod');
+    expect(w.type).toBe('bar');
+  });
+
   it('widgets bind to the opportunity object', () => {
     for (const w of PipelineDashboard.widgets) {
       expect((w as any).object).toBe('crm_opportunity');