@fayz-ai/plugin-reports 0.9.0-next.1 → 0.9.1

package/README.md

@@ -1,6 +1,6 @@
 # @fayz-ai/plugin-reports
 
-> **Status: experimental (incubating).** Not capability-complete — missing some or all of the capability bar (data-provider contract w/ supabase+mock pair, entity registries, settings, migrations; see `docs/PLUGIN-PATTERNS.md`). Fine to explore in dogfoods; NOT ready for fresh installs or generated apps, and its API may change without notice.
+> **Status: experimental (incubating).** Not capability-complete — missing some or all of the capability bar (data-provider contract w/ supabase+mock pair, entity registries, settings, migrations; see `docs/plugins/PLUGIN-PATTERNS.md`). Fine to explore in dogfoods; NOT ready for fresh installs or generated apps, and its API may change without notice.
 
 > Config-driven reports for your SaaS — declare the report, get the page.
 
@@ -23,11 +23,11 @@ It's the read layer of the SDK: point it at the same data the rest of your app a
 ```bash
 npm install @fayz-ai/plugin-reports
 ```
-Peer deps: `react`, `react-dom`. Runtime deps include `@fayz-ai/core`, `@fayz-ai/ui`, and `@fayz-ai/saas`.
+Peer deps: `react`, `react-dom`. Runtime deps include `@fayz-ai/core`, `@fayz-ai/ui`, and `@fayz-ai/admin`.
 
 ## Usage
 ```tsx
-import { defineSaas } from '@fayz-ai/saas'
+import { defineSaas } from '@fayz-ai/admin'
 import { createReportsPlugin } from '@fayz-ai/plugin-reports'
 
 export const app = defineSaas({
@@ -52,4 +52,4 @@ export const app = defineSaas({
 `plugin-reports` is the analytics surface of the SDK. It naturally reads from `@fayz-ai/plugin-financial` (revenue, commissions) and `@fayz-ai/plugin-agenda` (bookings, occupancy) to turn operational data into reports.
 
 ## Roadmap & contributing
-Built and evolving in the open. See the [Fayz SDK roadmap](../../docs/ROADMAP.md#plugin-reports) for current gaps, missing features, and good first issues.
+Built and evolving in the open. See the [Fayz SDK roadmap](../../docs/platform/ROADMAP.md#plugin-reports) for current gaps, missing features, and good first issues.

package/dist/{chunk-LODXZ2SC.js → chunk-2ZFN6ECM.js}

@@ -1,5 +1,5 @@
 import React from 'react';
-import { PersonLink } from '@fayz-ai/saas';
+import { PersonLink } from '@fayz-ai/admin';
 import { formatDateTime as formatDateTime$1, formatDate as formatDate$1, formatCurrency as formatCurrency$1 } from '@fayz-ai/core';
 
 // src/lib/columns.ts
@@ -96,5 +96,5 @@ function reportColumnsToTanstack(columns, currency) {
 }
 
 export { formatValuePlain, reportColumnsToTanstack };
-//# sourceMappingURL=chunk-LODXZ2SC.js.map
-//# sourceMappingURL=chunk-LODXZ2SC.js.map
+//# sourceMappingURL=chunk-2ZFN6ECM.js.map
+//# sourceMappingURL=chunk-2ZFN6ECM.js.map

package/dist/chunk-2ZFN6ECM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/columns.ts"],"names":["formatCurrencyLocale","formatDateLocale","formatDateTimeLocale"],"mappings":"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","file":"chunk-2ZFN6ECM.js","sourcesContent":["import React from 'react'\nimport type { ColumnDef } from '@tanstack/react-table'\nimport type { ReportColumnDef } from '../types'\nimport { PersonLink } from '@fayz-ai/admin'\nimport {\n  formatCurrency as formatCurrencyLocale,\n  formatDate as formatDateLocale,\n  formatDateTime as formatDateTimeLocale,\n} from '@fayz-ai/core'\n\n// ---------------------------------------------------------------------------\n// Formatters (mirrors fieldToColumn.tsx logic)\n// ---------------------------------------------------------------------------\n\nfunction formatCurrency(value: any, currency?: string): string {\n  const num = typeof value === 'number' ? value : parseFloat(value)\n  if (isNaN(num)) return '—'\n  return formatCurrencyLocale(num, currency)\n}\n\nfunction formatDate(value: any): string {\n  if (!value) return '—'\n  return formatDateLocale(value)\n}\n\nfunction formatDateTime(value: any): string {\n  if (!value) return '—'\n  return formatDateTimeLocale(value)\n}\n\nfunction formatNumber(value: any): string {\n  if (value == null) return '—'\n  return typeof value === 'number' ? value.toLocaleString() : String(value)\n}\n\n// ---------------------------------------------------------------------------\n// Plain-text formatter for exports\n// ---------------------------------------------------------------------------\n\nexport function formatValuePlain(value: any, col: ReportColumnDef, currency?: string): string {\n  if (value == null || value === '') return ''\n  switch (col.type) {\n    case 'currency':\n      return formatCurrency(value, col.currency ?? currency)\n    case 'date':\n      return formatDate(value)\n    case 'datetime':\n      return formatDateTime(value)\n    case 'number':\n      return formatNumber(value)\n    case 'boolean':\n      return value ? 'Yes' : 'No'\n    default:\n      return String(value)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ReportColumnDef[] → TanStack ColumnDef[]\n// ---------------------------------------------------------------------------\n\nexport function reportColumnsToTanstack(\n  columns: ReportColumnDef[],\n  currency?: string,\n): ColumnDef<Record<string, any>>[] {\n  return columns\n    .filter((c) => c.visible !== false)\n    .map((col): ColumnDef<Record<string, any>> => {\n      const sortable = col.sortable ?? ['text', 'number', 'currency', 'date', 'datetime', 'email'].includes(col.type)\n      const alignRight = col.align === 'right' || (!col.align && (col.type === 'currency' || col.type === 'number'))\n      const alignCenter = col.align === 'center'\n\n      return {\n        accessorKey: col.key,\n        header: col.label,\n        enableSorting: sortable,\n        cell: (ctx) => {\n          const value = ctx.getValue()\n          const row = ctx.row.original\n\n          if (col.renderCell) {\n            return col.renderCell(value, row)\n          }\n\n          if (value == null || value === '') {\n            return React.createElement('span', { className: 'text-muted-foreground' }, '—')\n          }\n\n          let content: React.ReactNode\n          switch (col.type) {\n            case 'person':\n              content = React.createElement(PersonLink, {\n                personId: col.idKey ? row[col.idKey] : null,\n                name: String(value),\n                size: 'sm',\n                className: 'text-xs',\n              })\n              break\n            case 'currency':\n              content = formatCurrency(value, col.currency ?? currency)\n              break\n            case 'date':\n              content = formatDate(value)\n              break\n            case 'datetime':\n              content = formatDateTime(value)\n              break\n            case 'boolean':\n              content = value\n                ? React.createElement('svg', { className: 'h-4 w-4 text-success', viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: '2' },\n                    React.createElement('polyline', { points: '20 6 9 17 4 12' }),\n                  )\n                : React.createElement('span', { className: 'text-muted-foreground' }, '—')\n              break\n            case 'number':\n              content = formatNumber(value)\n              break\n            default:\n              content = String(value)\n          }\n\n          const cls = alignRight ? 'text-right' : alignCenter ? 'text-center' : undefined\n          return cls\n            ? React.createElement('div', { className: cls }, content)\n            : React.createElement(React.Fragment, null, content)\n        },\n        meta: { align: alignRight ? 'right' : alignCenter ? 'center' : 'left' },\n      }\n    })\n}\n"]}

package/dist/{ReportsContext.d.ts → context.d.ts}

@@ -13,4 +13,4 @@ export declare function ReportsContextProvider({ config, provider, children, }:
     children: React.ReactNode;
 }): React.JSX.Element;
 export {};
-//# sourceMappingURL=ReportsContext.d.ts.map
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAA;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEtD,UAAU,mBAAmB;IAC3B,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB;AAID,wBAAgB,iBAAiB,IAAI,mBAAmB,CAIvD;AAED,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,qBAMA"}

package/dist/data/aggregate.d.ts

@@ -0,0 +1,14 @@
+import type { AnalyticsCardDef, AnalyticsGrain, AnalyticsQueryState, AnalyticsResult, AnalyticsRow } from '@fayz-ai/core';
+/** Truncate a timestamp to the start of its bucket — the JS date_trunc. */
+export declare function truncate(value: unknown, grain: AnalyticsGrain): string | null;
+export interface AggregateOptions {
+    /** Skip pagination and return every group (the export path). */
+    all?: boolean;
+}
+/**
+ * Group, aggregate, sort and page a row set exactly as analytics_run does.
+ * Returns the same {rows, total, summary} envelope so callers cannot tell which
+ * engine answered.
+ */
+export declare function aggregateRows(source: AnalyticsRow[], card: AnalyticsCardDef, state: AnalyticsQueryState, options?: AggregateOptions): AnalyticsResult;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/data/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/data/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EACrF,MAAM,eAAe,CAAA;AAkBtB,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAmB7E;AA2CD,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CA+CjB"}

package/dist/data/analytics-mock.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyticsProvider } from '@fayz-ai/core';
+export declare function createMockAnalyticsProvider(): AnalyticsProvider;
+//# sourceMappingURL=analytics-mock.d.ts.map

package/dist/data/analytics-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-mock.d.ts","sourceRoot":"","sources":["../../src/data/analytics-mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACQ,iBAAiB,EACpC,MAAM,eAAe,CAAA;AA4CtB,wBAAgB,2BAA2B,IAAI,iBAAiB,CAgD/D"}

package/dist/data/analytics-supabase.d.ts

@@ -0,0 +1,7 @@
+import type { AnalyticsProvider } from '@fayz-ai/core';
+export interface SupabaseAnalyticsProviderConfig {
+    tenantId: string | (() => string | undefined);
+    schema?: string;
+}
+export declare function createSupabaseAnalyticsProvider(config: SupabaseAnalyticsProviderConfig): AnalyticsProvider;
+//# sourceMappingURL=analytics-supabase.d.ts.map

package/dist/data/analytics-supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-supabase.d.ts","sourceRoot":"","sources":["../../src/data/analytics-supabase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACQ,iBAAiB,EACpC,MAAM,eAAe,CAAA;AAsHtB,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAA;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,+BAA+B,GAAG,iBAAiB,CA+F1G"}

package/dist/{excel-QHUSM6IH.js → excel-WE73YE2V.js}

@@ -1,4 +1,4 @@
-import { formatValuePlain } from './chunk-LODXZ2SC.js';
+import { formatValuePlain } from './chunk-2ZFN6ECM.js';
 
 // src/export/excel.ts
 var load = (m) => new Function("m", "return import(m)")(m);
@@ -31,5 +31,5 @@ async function isExcelAvailable() {
 }
 
 export { exportToExcel, isExcelAvailable };
-//# sourceMappingURL=excel-QHUSM6IH.js.map
-//# sourceMappingURL=excel-QHUSM6IH.js.map
+//# sourceMappingURL=excel-WE73YE2V.js.map
+//# sourceMappingURL=excel-WE73YE2V.js.map

package/dist/{excel-QHUSM6IH.js.map → excel-WE73YE2V.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/export/excel.ts"],"names":[],"mappings":";;;AAKA,IAAM,IAAA,GAAO,CAAC,CAAA,KAAc,IAAI,SAAS,GAAA,EAAK,kBAAkB,EAAE,CAAC,CAAA;AAEnE,eAAsB,aAAA,CACpB,OAAA,EACA,IAAA,EACA,QAAA,EACA,QAAA,EACe;AACf,EAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,MAAM,CAAA;AAC9B,EAAA,MAAM,cAAc,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,YAAY,KAAK,CAAA;AAE7D,EAAA,MAAM,SAAS,WAAA,CAAY,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,KAAK,CAAA;AAC7C,EAAA,MAAM,OAAO,IAAA,CAAK,GAAA;AAAA,IAAI,CAAC,GAAA,KACrB,WAAA,CAAY,GAAA,CAAI,CAAC,GAAA,KAAQ;AACvB,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA;AACzB,MAAA,IAAI,GAAA,CAAI,IAAA,KAAS,QAAA,IAAY,GAAA,CAAI,SAAS,UAAA,EAAY;AACpD,QAAA,MAAM,MAAM,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,WAAW,KAAK,CAAA;AAChE,QAAA,OAAO,KAAA,CAAM,GAAG,CAAA,GAAI,EAAA,GAAK,GAAA;AAAA,MAC3B;AACA,MAAA,OAAO,gBAAA,CAAiB,KAAA,EAAO,GAAA,EAAK,QAAQ,CAAA;AAAA,IAC9C,CAAC;AAAA,GACH;AAEA,EAAA,MAAM,EAAA,GAAK,KAAK,KAAA,CAAM,YAAA,CAAa,CAAC,MAAA,EAAQ,GAAG,IAAI,CAAC,CAAA;AACpD,EAAA,MAAM,EAAA,GAAK,IAAA,CAAK,KAAA,CAAM,QAAA,EAAS;AAC/B,EAAA,IAAA,CAAK,KAAA,CAAM,iBAAA,CAAkB,EAAA,EAAI,EAAA,EAAI,QAAQ,CAAA;AAC7C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,CAAA,EAAG,QAAQ,CAAA,KAAA,CAAO,CAAA;AACvC;AAEA,eAAsB,gBAAA,GAAqC;AACzD,EAAA,IAAI;AACF,IAAA,MAAM,KAAK,MAAM,CAAA;AACjB,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF","file":"excel-QHUSM6IH.js","sourcesContent":["import type { ReportColumnDef } from '../types'\nimport { formatValuePlain } from '../lib/columns'\n\n// Opaque dynamic import — hidden from Vite's static analysis so it won't\n// fail when xlsx is not installed (it's an optional peer dependency).\nconst load = (m: string) => new Function('m', 'return import(m)')(m) as Promise<any>\n\nexport async function exportToExcel(\n  columns: ReportColumnDef[],\n  data: Record<string, any>[],\n  filename: string,\n  currency?: string,\n): Promise<void> {\n  const XLSX = await load('xlsx')\n  const visibleCols = columns.filter((c) => c.visible !== false)\n\n  const header = visibleCols.map((c) => c.label)\n  const rows = data.map((row) =>\n    visibleCols.map((col) => {\n      const value = row[col.key]\n      if (col.type === 'number' || col.type === 'currency') {\n        const num = typeof value === 'number' ? value : parseFloat(value)\n        return isNaN(num) ? '' : num\n      }\n      return formatValuePlain(value, col, currency)\n    }),\n  )\n\n  const ws = XLSX.utils.aoa_to_sheet([header, ...rows])\n  const wb = XLSX.utils.book_new()\n  XLSX.utils.book_append_sheet(wb, ws, 'Report')\n  XLSX.writeFile(wb, `${filename}.xlsx`)\n}\n\nexport async function isExcelAvailable(): Promise<boolean> {\n  try {\n    await load('xlsx')\n    return true\n  } catch {\n    return false\n  }\n}\n"]}
+{"version":3,"sources":["../src/export/excel.ts"],"names":[],"mappings":";;;AAKA,IAAM,IAAA,GAAO,CAAC,CAAA,KAAc,IAAI,SAAS,GAAA,EAAK,kBAAkB,EAAE,CAAC,CAAA;AAEnE,eAAsB,aAAA,CACpB,OAAA,EACA,IAAA,EACA,QAAA,EACA,QAAA,EACe;AACf,EAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,MAAM,CAAA;AAC9B,EAAA,MAAM,cAAc,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,YAAY,KAAK,CAAA;AAE7D,EAAA,MAAM,SAAS,WAAA,CAAY,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,KAAK,CAAA;AAC7C,EAAA,MAAM,OAAO,IAAA,CAAK,GAAA;AAAA,IAAI,CAAC,GAAA,KACrB,WAAA,CAAY,GAAA,CAAI,CAAC,GAAA,KAAQ;AACvB,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA;AACzB,MAAA,IAAI,GAAA,CAAI,IAAA,KAAS,QAAA,IAAY,GAAA,CAAI,SAAS,UAAA,EAAY;AACpD,QAAA,MAAM,MAAM,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,WAAW,KAAK,CAAA;AAChE,QAAA,OAAO,KAAA,CAAM,GAAG,CAAA,GAAI,EAAA,GAAK,GAAA;AAAA,MAC3B;AACA,MAAA,OAAO,gBAAA,CAAiB,KAAA,EAAO,GAAA,EAAK,QAAQ,CAAA;AAAA,IAC9C,CAAC;AAAA,GACH;AAEA,EAAA,MAAM,EAAA,GAAK,KAAK,KAAA,CAAM,YAAA,CAAa,CAAC,MAAA,EAAQ,GAAG,IAAI,CAAC,CAAA;AACpD,EAAA,MAAM,EAAA,GAAK,IAAA,CAAK,KAAA,CAAM,QAAA,EAAS;AAC/B,EAAA,IAAA,CAAK,KAAA,CAAM,iBAAA,CAAkB,EAAA,EAAI,EAAA,EAAI,QAAQ,CAAA;AAC7C,EAAA,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,CAAA,EAAG,QAAQ,CAAA,KAAA,CAAO,CAAA;AACvC;AAEA,eAAsB,gBAAA,GAAqC;AACzD,EAAA,IAAI;AACF,IAAA,MAAM,KAAK,MAAM,CAAA;AACjB,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF","file":"excel-WE73YE2V.js","sourcesContent":["import type { ReportColumnDef } from '../types'\nimport { formatValuePlain } from '../lib/columns'\n\n// Opaque dynamic import — hidden from Vite's static analysis so it won't\n// fail when xlsx is not installed (it's an optional peer dependency).\nconst load = (m: string) => new Function('m', 'return import(m)')(m) as Promise<any>\n\nexport async function exportToExcel(\n  columns: ReportColumnDef[],\n  data: Record<string, any>[],\n  filename: string,\n  currency?: string,\n): Promise<void> {\n  const XLSX = await load('xlsx')\n  const visibleCols = columns.filter((c) => c.visible !== false)\n\n  const header = visibleCols.map((c) => c.label)\n  const rows = data.map((row) =>\n    visibleCols.map((col) => {\n      const value = row[col.key]\n      if (col.type === 'number' || col.type === 'currency') {\n        const num = typeof value === 'number' ? value : parseFloat(value)\n        return isNaN(num) ? '' : num\n      }\n      return formatValuePlain(value, col, currency)\n    }),\n  )\n\n  const ws = XLSX.utils.aoa_to_sheet([header, ...rows])\n  const wb = XLSX.utils.book_new()\n  XLSX.utils.book_append_sheet(wb, ws, 'Report')\n  XLSX.writeFile(wb, `${filename}.xlsx`)\n}\n\nexport async function isExcelAvailable(): Promise<boolean> {\n  try {\n    await load('xlsx')\n    return true\n  } catch {\n    return false\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,6 +1,68 @@
-import type { PluginManifest } from '@fayz-ai/core';
+import type { PluginManifest, PluginScope, VerticalId, AnalyticsCardDef, AnalyticsProvider, AnalyticsCompare } from '@fayz-ai/core';
+import type { AnalyticsRangePreset } from '@fayz-ai/ui';
+import { type AnalyticsLabels } from './views/AnalyticsSurface';
 import type { ReportsPluginOptions } from './types';
+export interface AnalyticsPluginOptions {
+    /**
+     * Cards the host app contributes or overrides. Cards owned by a plugin come
+     * through the runtime registry automatically — this is for app-specific ones
+     * and for retuning a plugin card by re-declaring its id.
+     */
+    cards?: AnalyticsCardDef[];
+    /**
+     * Legacy ReportDef catalogue. Still fully supported: each becomes a table
+     * card in the report list. See lib/legacy.ts.
+     */
+    reports?: import('./types').ReportDef[];
+    /** Attribution for pre-built cards — the product name, e.g. 'FayzShop'. */
+    createdBy?: string;
+    labels?: Partial<AnalyticsLabels>;
+    currency?: {
+        code?: string;
+        locale?: string;
+        symbol?: string;
+    };
+    dataProvider?: AnalyticsProvider;
+    navPosition?: number;
+    navSection?: 'main' | 'secondary';
+    scope?: PluginScope;
+    verticalId?: VerticalId;
+    defaultPageSize?: number;
+    /**
+     * Render an in-content title above the page. Default: FALSE, matching
+     * DashboardCanvas — the admin shell's top bar already names the page from the
+     * active nav entry, so a title here prints the same word twice. Pass true
+     * only where the surface is embedded with no chrome of its own.
+     */
+    showHeader?: boolean;
+    /** Register the Live View nav entry. Default: false while it is a stub. */
+    showLiveView?: boolean;
+    /**
+     * Range the surface opens on. Default 'last_30_days' — the common business
+     * month. Set it where the domain's natural period differs (a school term, a
+     * quarter), not to compensate for how much data a demo tenant happens to have.
+     */
+    defaultRange?: AnalyticsRangePreset;
+    defaultCompare?: AnalyticsCompare;
+}
+export declare function createAnalyticsPlugin(options?: AnalyticsPluginOptions): PluginManifest;
+/**
+ * @deprecated Prefer `createAnalyticsPlugin`. Kept so the apps that call
+ * `createReportsPlugin({ reports: [...] })` keep working unchanged — the legacy
+ * `reports` option is still first-class and their catalogues need no rewrite.
+ */
 export declare function createReportsPlugin(options: ReportsPluginOptions): PluginManifest;
+export { AnalyticsSurface, ANALYTICS_BASE, REPORTS_BASE, cardColumns, useAnalyticsConfig, useAnalyticsCards, useOverviewCards, } from './views/AnalyticsSurface';
+export type { AnalyticsLabels, ResolvedAnalyticsConfig } from './views/AnalyticsSurface';
+export { AnalyticsOverview } from './views/AnalyticsOverview';
+export { ReportsListPage } from './views/ReportsListPage';
+export { AnalyticsReportViewer } from './views/AnalyticsReportViewer';
+export { reportDefToCard, reportDefsToCards } from './lib/legacy';
+export { aggregateRows } from './data/aggregate';
+export { createSupabaseAnalyticsProvider } from './data/analytics-supabase';
+export type { SupabaseAnalyticsProviderConfig } from './data/analytics-supabase';
+export { createMockAnalyticsProvider } from './data/analytics-mock';
+export { markViewed, useLastViewed } from './lib/lastViewed';
 export type { ReportDef, ReportColumnDef, ReportFilterDef, ReportDateRange, ReportQueryState, ReportBadge, ReportDataSource, ReportGrain, ReportAllowedAction, ReportFilterOption, ReportsPluginOptions, ReportsPluginLabels, ResolvedReportsConfig, } from './types';
 export type { ReportDataProvider, ReportResult } from './data/types';
 export { createSupabaseReportProvider } from './data/supabase';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,eAAe,CAAA;AAQ5E,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,SAAS,CAAA;AA2DhB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CA4CjF;AAMD,YAAY,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}