@happyvertical/smrt-reports 0.57.5 → 0.57.7

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-reports",
-  "packageVersion": "0.57.5",
+  "packageVersion": "0.57.7",
   "objects": {
     "@happyvertical/smrt-reports:SmrtReport": {
       "name": "smrtreport",
@@ -2772,17 +2772,41 @@
       ],
       "nav": [
         {
-          "label": "Shared reports",
+          "label": "Saved reports",
           "model": "@happyvertical/smrt-reports:RuntimeReport",
-          "icon": "fileText"
+          "icon": "fileText",
+          "description": "Reports your team approved, kept up to date.",
+          "noun": "report"
         }
       ],
       "requires": [],
       "help": {
-        "markdown": "# Reports\n\nAsk the assistant for a total, comparison, or trend. Review the proposed report\nand approve it to save it. Your saved reports are shared with your team; each\nperson sees results using their own access to the underlying information.\n\nReports run fresh when opened. You can archive a report to hide it from the\nactive list and restore it later. Creating and restoring reports needs report\nwriting access. Reports need a connected server and are unavailable in offline\npreviews. Scheduling, renaming, and exporting reports are not available yet.\n",
+        "markdown": "# Reports\n\nAsk the assistant for a total, comparison, or trend. Review the proposed report\nand approve it to save it. Your saved reports are shared with your team; each\nperson sees results using their own access to the underlying information.\n\nReports run fresh when opened. You can archive a report to hide it from the\nactive list and restore it later. Creating and restoring reports needs report\nwriting access. Reports need a connected server; the smrt planner previews them over its\nsample records instead. Scheduling, renaming, and exporting reports are not available yet.\n",
         "fieldRefs": []
       },
       "surfaces": [
+        {
+          "kind": "widget",
+          "type": "saved-reports",
+          "export": "@happyvertical/smrt-reports/svelte#SavedReportsWidget",
+          "label": "Saved reports",
+          "description": "Your team’s saved reports with their latest figures.",
+          "icon": "fileText",
+          "options": [
+            {
+              "key": "limit",
+              "type": "integer",
+              "label": "Reports shown",
+              "default": 6,
+              "min": 1,
+              "max": 24
+            }
+          ],
+          "sectionDefault": true,
+          "defaultSpan": 4,
+          "minSpan": 2,
+          "maxSpan": 4
+        },
         {
           "kind": "route",
           "path": "/reports",

package/dist/playground.js

@@ -84,7 +84,7 @@ var playground_default = {
 		{
 			id: "saved-reports",
 			title: "Saved reports",
-			description: "Shared reports, author filter, and archive controls.",
+			description: "Saved reports as cards, whose and archived filters, and archive in a menu.",
 			loadComponent: () => import("./svelte/SavedReports.svelte").then((m) => m.default),
 			props: { client: client() },
 			order: 1

package/dist/playground.js.map

@@ -1 +1 @@
-{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/preview-data.ts","../src/svelte/playground.ts"],"sourcesContent":["import type {\n  RuntimeReportProposal,\n  RuntimeReportResult,\n  RuntimeReportSpec,\n  RuntimeReportsClient,\n  SavedRuntimeReport,\n} from './types.js';\n\nexport const spec: RuntimeReportSpec = {\n  version: 1,\n  title: 'Sales by region',\n  source: 'sales',\n  dimensions: [{ field: 'region', as: 'region' }],\n  measures: [{ fn: 'sum', field: 'amount', as: 'total' }],\n  filters: [],\n  having: [],\n  sort: [],\n  limit: 100,\n  chart: { type: 'bar', x: 'region', y: ['total'] },\n};\nexport const result: RuntimeReportResult = {\n  version: 1,\n  specHash: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',\n  title: spec.title,\n  columns: [\n    { id: 'region', label: 'Region', role: 'dimension', type: 'string' },\n    {\n      id: 'total',\n      label: 'Total',\n      role: 'measure',\n      type: 'integer',\n      format: 'money',\n    },\n  ],\n  rows: [{ region: 'West', total: 12345 }],\n  rowCount: 1,\n  truncated: false,\n  ranAt: '2026-10-13T12:00:00Z',\n  chart: spec.chart,\n};\nexport const saved: SavedRuntimeReport = {\n  id: 'report-1',\n  title: spec.title,\n  sourceId: 'sales',\n  createdByUserId: 'alice',\n  status: 'active',\n  spec,\n  canArchive: true,\n};\nexport const proposal: RuntimeReportProposal = {\n  status: 'awaiting_confirmation',\n  specHash: result.specHash,\n  spec,\n  preview: result,\n  sourceLabel: 'Sales',\n  confirmPath: '/api/_reports/runtime/confirm',\n};\nexport function client(\n  overrides: Partial<RuntimeReportsClient> = {},\n): RuntimeReportsClient {\n  return {\n    list: async () => [saved],\n    get: async () => saved,\n    run: async () => result,\n    archive: async () => {},\n    confirm: async () => saved,\n    ...overrides,\n  };\n}\n","import { client, proposal, result, saved } from './preview-data.js';\n\nexport default {\n  packageName: '@happyvertical/smrt-reports',\n  displayName: 'Reports',\n  description: 'Saved runtime reports and live results.',\n  entries: [\n    {\n      id: 'saved-reports',\n      title: 'Saved reports',\n      description: 'Shared reports, author filter, and archive controls.',\n      loadComponent: () =>\n        import('./SavedReports.svelte').then((m) => m.default),\n      props: { client: client() },\n      order: 1,\n    },\n    {\n      id: 'report-detail',\n      title: 'Report detail',\n      description: 'Money values with chart and table views.',\n      loadComponent: () =>\n        import('./ReportDetail.svelte').then((m) => m.default),\n      props: { id: saved.id, client: client(), locale: 'en-US' },\n      order: 2,\n    },\n    {\n      id: 'report-confirmation',\n      title: 'Report confirmation',\n      description: 'Review a bounded proposal before saving.',\n      loadComponent: () =>\n        import('./ReportConfirmation.svelte').then((m) => m.default),\n      props: { proposal, confirm: async () => saved },\n      order: 3,\n    },\n    {\n      id: 'report-picker',\n      title: 'Report picker',\n      description: 'Choose a saved report and its measure.',\n      loadComponent: () =>\n        import('./ReportPicker.svelte').then((m) => m.default),\n      props: {\n        client: client(),\n        reportId: saved.id,\n        measure: 'total',\n        dimension: 'region',\n        onchange: () => {},\n      },\n      order: 4,\n    },\n    {\n      id: 'reports-unavailable',\n      title: 'Reports unavailable',\n      description: 'Static hosts do not make server requests.',\n      loadComponent: () =>\n        import('./RuntimeReportsRoute.svelte').then((m) => m.default),\n      props: { serverAvailable: false },\n      order: 5,\n    },\n    {\n      id: 'report-empty',\n      title: 'Empty report',\n      description: 'A valid report with no matching rows.',\n      loadComponent: () =>\n        import('./ReportResult.svelte').then((m) => m.default),\n      props: { result: { ...result, rows: [], rowCount: 0 } },\n      order: 6,\n    },\n  ],\n};\n"],"mappings":";AAQO,IAAM,OAA0B;CACrC,SAAS;CACT,OAAO;CACP,QAAQ;CACR,YAAY,CAAC;EAAE,OAAO;EAAU,IAAI;CAAS,CAAC;CAC9C,UAAU,CAAC;EAAE,IAAI;EAAO,OAAO;EAAU,IAAI;CAAQ,CAAC;CACtD,SAAS,CAAC;CACV,QAAQ,CAAC;CACT,MAAM,CAAC;CACP,OAAO;CACP,OAAO;EAAE,MAAM;EAAO,GAAG;EAAU,GAAG,CAAC,OAAO;CAAE;AAClD;AACO,IAAM,SAA8B;CACzC,SAAS;CACT,UAAU;CACV,OAAO,KAAK;CACZ,SAAS,CACP;EAAE,IAAI;EAAU,OAAO;EAAU,MAAM;EAAa,MAAM;CAAS,GACnE;EACE,IAAI;EACJ,OAAO;EACP,MAAM;EACN,MAAM;EACN,QAAQ;CACV,CACF;CACA,MAAM,CAAC;EAAE,QAAQ;EAAQ,OAAO;CAAM,CAAC;CACvC,UAAU;CACV,WAAW;CACX,OAAO;CACP,OAAO,KAAK;AACd;AACO,IAAM,QAA4B;CACvC,IAAI;CACJ,OAAO,KAAK;CACZ,UAAU;CACV,iBAAiB;CACjB,QAAQ;CACR;CACA,YAAY;AACd;AACO,IAAM,WAAkC;CAC7C,QAAQ;CACR,UAAU,OAAO;CACjB;CACA,SAAS;CACT,aAAa;CACb,aAAa;AACf;AACO,SAAS,OACd,YAA2C,CAAC,GACtB;CACtB,OAAO;EACL,MAAM,YAAY,CAAC,KAAK;EACxB,KAAK,YAAY;EACjB,KAAK,YAAY;EACjB,SAAS,YAAY,CAAC;EACtB,SAAS,YAAY;EACrB,GAAG;CACL;AACF;;;AClEA,IAAA,qBAAe;CACb,aAAa;CACb,aAAa;CACb,aAAa;CACb,SAAS;EACP;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO,EAAE,QAAQ,OAAO,EAAE;GAC1B,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO;IAAE,IAAI,MAAM;IAAI,QAAQ,OAAO;IAAG,QAAQ;GAAQ;GACzD,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,qCAA6B,CAAE,MAAM,MAAM,EAAE,OAAO;GAC7D,OAAO;IAAE;IAAU,SAAS,YAAY;GAAM;GAC9C,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO;IACL,QAAQ,OAAO;IACf,UAAU,MAAM;IAChB,SAAS;IACT,WAAW;IACX,gBAAgB,CAAC;GACnB;GACA,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,sCAA8B,CAAE,MAAM,MAAM,EAAE,OAAO;GAC9D,OAAO,EAAE,iBAAiB,MAAM;GAChC,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO,EAAE,QAAQ;IAAE,GAAG;IAAQ,MAAM,CAAC;IAAG,UAAU;GAAE,EAAE;GACtD,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/preview-data.ts","../src/svelte/playground.ts"],"sourcesContent":["import type {\n  RuntimeReportProposal,\n  RuntimeReportResult,\n  RuntimeReportSpec,\n  RuntimeReportsClient,\n  SavedRuntimeReport,\n} from './types.js';\n\nexport const spec: RuntimeReportSpec = {\n  version: 1,\n  title: 'Sales by region',\n  source: 'sales',\n  dimensions: [{ field: 'region', as: 'region' }],\n  measures: [{ fn: 'sum', field: 'amount', as: 'total' }],\n  filters: [],\n  having: [],\n  sort: [],\n  limit: 100,\n  chart: { type: 'bar', x: 'region', y: ['total'] },\n};\nexport const result: RuntimeReportResult = {\n  version: 1,\n  specHash: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',\n  title: spec.title,\n  columns: [\n    { id: 'region', label: 'Region', role: 'dimension', type: 'string' },\n    {\n      id: 'total',\n      label: 'Total',\n      role: 'measure',\n      type: 'integer',\n      format: 'money',\n    },\n  ],\n  rows: [{ region: 'West', total: 12345 }],\n  rowCount: 1,\n  truncated: false,\n  ranAt: '2026-10-13T12:00:00Z',\n  chart: spec.chart,\n};\nexport const saved: SavedRuntimeReport = {\n  id: 'report-1',\n  title: spec.title,\n  sourceId: 'sales',\n  createdByUserId: 'alice',\n  status: 'active',\n  spec,\n  canArchive: true,\n};\nexport const proposal: RuntimeReportProposal = {\n  status: 'awaiting_confirmation',\n  specHash: result.specHash,\n  spec,\n  preview: result,\n  sourceLabel: 'Sales',\n  confirmPath: '/api/_reports/runtime/confirm',\n};\nexport function client(\n  overrides: Partial<RuntimeReportsClient> = {},\n): RuntimeReportsClient {\n  return {\n    list: async () => [saved],\n    get: async () => saved,\n    run: async () => result,\n    archive: async () => {},\n    confirm: async () => saved,\n    ...overrides,\n  };\n}\n","import { client, proposal, result, saved } from './preview-data.js';\n\nexport default {\n  packageName: '@happyvertical/smrt-reports',\n  displayName: 'Reports',\n  description: 'Saved runtime reports and live results.',\n  entries: [\n    {\n      id: 'saved-reports',\n      title: 'Saved reports',\n      description:\n        'Saved reports as cards, whose and archived filters, and archive in a menu.',\n      loadComponent: () =>\n        import('./SavedReports.svelte').then((m) => m.default),\n      props: { client: client() },\n      order: 1,\n    },\n    {\n      id: 'report-detail',\n      title: 'Report detail',\n      description: 'Money values with chart and table views.',\n      loadComponent: () =>\n        import('./ReportDetail.svelte').then((m) => m.default),\n      props: { id: saved.id, client: client(), locale: 'en-US' },\n      order: 2,\n    },\n    {\n      id: 'report-confirmation',\n      title: 'Report confirmation',\n      description: 'Review a bounded proposal before saving.',\n      loadComponent: () =>\n        import('./ReportConfirmation.svelte').then((m) => m.default),\n      props: { proposal, confirm: async () => saved },\n      order: 3,\n    },\n    {\n      id: 'report-picker',\n      title: 'Report picker',\n      description: 'Choose a saved report and its measure.',\n      loadComponent: () =>\n        import('./ReportPicker.svelte').then((m) => m.default),\n      props: {\n        client: client(),\n        reportId: saved.id,\n        measure: 'total',\n        dimension: 'region',\n        onchange: () => {},\n      },\n      order: 4,\n    },\n    {\n      id: 'reports-unavailable',\n      title: 'Reports unavailable',\n      description: 'Static hosts do not make server requests.',\n      loadComponent: () =>\n        import('./RuntimeReportsRoute.svelte').then((m) => m.default),\n      props: { serverAvailable: false },\n      order: 5,\n    },\n    {\n      id: 'report-empty',\n      title: 'Empty report',\n      description: 'A valid report with no matching rows.',\n      loadComponent: () =>\n        import('./ReportResult.svelte').then((m) => m.default),\n      props: { result: { ...result, rows: [], rowCount: 0 } },\n      order: 6,\n    },\n  ],\n};\n"],"mappings":";AAQO,IAAM,OAA0B;CACrC,SAAS;CACT,OAAO;CACP,QAAQ;CACR,YAAY,CAAC;EAAE,OAAO;EAAU,IAAI;CAAS,CAAC;CAC9C,UAAU,CAAC;EAAE,IAAI;EAAO,OAAO;EAAU,IAAI;CAAQ,CAAC;CACtD,SAAS,CAAC;CACV,QAAQ,CAAC;CACT,MAAM,CAAC;CACP,OAAO;CACP,OAAO;EAAE,MAAM;EAAO,GAAG;EAAU,GAAG,CAAC,OAAO;CAAE;AAClD;AACO,IAAM,SAA8B;CACzC,SAAS;CACT,UAAU;CACV,OAAO,KAAK;CACZ,SAAS,CACP;EAAE,IAAI;EAAU,OAAO;EAAU,MAAM;EAAa,MAAM;CAAS,GACnE;EACE,IAAI;EACJ,OAAO;EACP,MAAM;EACN,MAAM;EACN,QAAQ;CACV,CACF;CACA,MAAM,CAAC;EAAE,QAAQ;EAAQ,OAAO;CAAM,CAAC;CACvC,UAAU;CACV,WAAW;CACX,OAAO;CACP,OAAO,KAAK;AACd;AACO,IAAM,QAA4B;CACvC,IAAI;CACJ,OAAO,KAAK;CACZ,UAAU;CACV,iBAAiB;CACjB,QAAQ;CACR;CACA,YAAY;AACd;AACO,IAAM,WAAkC;CAC7C,QAAQ;CACR,UAAU,OAAO;CACjB;CACA,SAAS;CACT,aAAa;CACb,aAAa;AACf;AACO,SAAS,OACd,YAA2C,CAAC,GACtB;CACtB,OAAO;EACL,MAAM,YAAY,CAAC,KAAK;EACxB,KAAK,YAAY;EACjB,KAAK,YAAY;EACjB,SAAS,YAAY,CAAC;EACtB,SAAS,YAAY;EACrB,GAAG;CACL;AACF;;;AClEA,IAAA,qBAAe;CACb,aAAa;CACb,aAAa;CACb,aAAa;CACb,SAAS;EACP;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO,EAAE,QAAQ,OAAO,EAAE;GAC1B,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO;IAAE,IAAI,MAAM;IAAI,QAAQ,OAAO;IAAG,QAAQ;GAAQ;GACzD,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,qCAA6B,CAAE,MAAM,MAAM,EAAE,OAAO;GAC7D,OAAO;IAAE;IAAU,SAAS,YAAY;GAAM;GAC9C,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO;IACL,QAAQ,OAAO;IACf,UAAU,MAAM;IAChB,SAAS;IACT,WAAW;IACX,gBAAgB,CAAC;GACnB;GACA,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,sCAA8B,CAAE,MAAM,MAAM,EAAE,OAAO;GAC9D,OAAO,EAAE,iBAAiB,MAAM;GAChC,OAAO;EACT;EACA;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,qBACE,OAAO,+BAAuB,CAAE,MAAM,MAAM,EAAE,OAAO;GACvD,OAAO,EAAE,QAAQ;IAAE,GAAG;IAAQ,MAAM,CAAC;IAAG,UAAU;GAAE,EAAE;GACtD,OAAO;EACT;CACF;AACF"}

package/dist/recipes.d.ts

@@ -38,8 +38,29 @@ export declare class RuntimeReportsRecipe extends SmrtRecipe {
         label: string;
         model: typeof RuntimeReport;
         icon: string;
+        noun: string;
+        description: string;
     }[];
     static surfaces: readonly [{
+        readonly kind: "widget";
+        readonly type: "saved-reports";
+        readonly export: "@happyvertical/smrt-reports/svelte#SavedReportsWidget";
+        readonly label: "Saved reports";
+        readonly description: "Your team’s saved reports with their latest figures.";
+        readonly icon: "fileText";
+        readonly options: readonly [{
+            readonly key: "limit";
+            readonly type: "integer";
+            readonly label: "Reports shown";
+            readonly min: 1;
+            readonly max: 24;
+            readonly default: 6;
+        }];
+        readonly sectionDefault: true;
+        readonly defaultSpan: 4;
+        readonly minSpan: 2;
+        readonly maxSpan: 4;
+    }, {
         readonly kind: "route";
         readonly path: "/reports";
         readonly export: "@happyvertical/smrt-reports/svelte#RuntimeReportsRoute";

package/dist/recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAE/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,qBAAa,yBAA0B,SAAQ,UAAU;IACvD,MAAM,CAAC,EAAE,SAA0B;IACnC,MAAM,CAAC,IAAI,SAA8B;IAIzC,MAAM,CAAC,KAAK,SAAuB;IACnC,MAAM,CAAC,OAAO,SAC+E;IAC7F,MAAM,CAAC,QAAQ,WAA2D;IAI1E,MAAM,CAAC,MAAM,oJAOX;IAGF,MAAM,CAAC,OAAO,EAAG,QAAQ,CAAU;CACpC;AAED,gFAAgF;AAChF,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,MAAM,CAAC,EAAE,SAAqB;IAC9B,MAAM,CAAC,KAAK,SAAa;IACzB,MAAM,CAAC,QAAQ,WAOb;IACF,MAAM,CAAC,OAAO,SAC8D;IAC5E,MAAM,CAAC,IAAI,SAAyB;IACpC,MAAM,CAAC,MAAM,2BAAmB;IAEhC,MAAM,CAAC,GAAG;;;;QAER;IACF,MAAM,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCJ;IACX,MAAM,CAAC,OAAO,EAAG,QAAQ,CAAU;CACpC"}
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAE/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,qBAAa,yBAA0B,SAAQ,UAAU;IACvD,MAAM,CAAC,EAAE,SAA0B;IACnC,MAAM,CAAC,IAAI,SAA8B;IAIzC,MAAM,CAAC,KAAK,SAAuB;IACnC,MAAM,CAAC,OAAO,SAC+E;IAC7F,MAAM,CAAC,QAAQ,WAA2D;IAI1E,MAAM,CAAC,MAAM,oJAOX;IAGF,MAAM,CAAC,OAAO,EAAG,QAAQ,CAAU;CACpC;AAED,gFAAgF;AAChF,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,MAAM,CAAC,EAAE,SAAqB;IAC9B,MAAM,CAAC,KAAK,SAAa;IACzB,MAAM,CAAC,QAAQ,WAOb;IACF,MAAM,CAAC,OAAO,SAC8D;IAC5E,MAAM,CAAC,IAAI,SAAyB;IACpC,MAAM,CAAC,MAAM,2BAAmB;IAEhC,MAAM,CAAC,GAAG;;;;;;QAQR;IACF,MAAM,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DJ;IACX,MAAM,CAAC,OAAO,EAAG,QAAQ,CAAU;CACpC"}

package/dist/runtime-compiler.d.ts

@@ -24,8 +24,10 @@
  *   cross-tenant option.
  */
 import type { DatabaseInterface, SqlAdapterType } from '@happyvertical/sql';
-import { type RuntimeReportChart, type RuntimeReportSpec } from './runtime-spec.js';
+import { type RuntimeReportColumn, type RuntimeReportResult, type RuntimeReportSourceDescription } from './runtime-plan.js';
+import { type RuntimeReportSpec } from './runtime-spec.js';
 import type { AggregateSpec } from './types.js';
+export type { RuntimeReportColumn, RuntimeReportColumnType, RuntimeReportResult, RuntimeReportSourceDescription, } from './runtime-plan.js';
 /** A server-owned report source. The spec refers to it only by `id`. */
 export interface RuntimeReportSourceDefinition {
     /** Opaque id the spec names; defaults to nothing, always explicit. */
@@ -44,6 +46,10 @@ export interface RuntimeReportSourceDefinition {
     fields?: readonly string[];
     /** Canonical public field names to remove; exclusions always win. */
     excludeFields?: readonly string[];
+    /** The natural date "by month" buckets (an invoice's issue date); derived when omitted. */
+    timeField?: string;
+    /** Fields worth grouping by, most useful first; derived when omitted. */
+    dimensions?: readonly string[];
 }
 export interface RuntimeReportCompileContext {
     /** Server-owned allow-list. A spec can reach nothing outside it. */
@@ -61,19 +67,6 @@ export interface RuntimeReportCompileContext {
     /** Host authorization for reading the source (for example RBAC `read`). */
     authorizeSource?: (source: RuntimeReportSourceDefinition) => void | Promise<void>;
 }
-export type RuntimeReportColumnType = 'string' | 'integer' | 'decimal' | 'boolean' | 'datetime' | 'id';
-export interface RuntimeReportColumn {
-    id: string;
-    label: string;
-    role: 'dimension' | 'measure';
-    type: RuntimeReportColumnType;
-    /** Source field this column derives from (absent for a row count). */
-    field?: string;
-    fn?: string;
-    bucket?: string;
-    /** Field format hint carried from the model (for example `money`). */
-    format?: string;
-}
 export interface CompiledRuntimeReport {
     version: 1;
     specHash: string;
@@ -93,32 +86,6 @@ export interface CompiledRuntimeReport {
         tenantId: string | null;
     };
 }
-export interface RuntimeReportResult {
-    version: 1;
-    specHash: string;
-    title: string;
-    columns: RuntimeReportColumn[];
-    rows: Record<string, string | number | boolean | null>[];
-    rowCount: number;
-    /** True when more rows existed than the spec/host limit. */
-    truncated: boolean;
-    ranAt: string;
-    chart: RuntimeReportChart;
-}
-export interface RuntimeReportSourceDescription {
-    id: string;
-    label: string;
-    description?: string;
-    /** Fields the live principal may group by, filter on or aggregate. */
-    fields: {
-        name: string;
-        label: string;
-        type: RuntimeReportColumnType;
-        format?: string;
-        filterOperators: readonly string[];
-        aggregates: readonly string[];
-    }[];
-}
 /**
  * Describe what a spec may reference on one source for the live principal:
  * exactly the field set the compiler would admit, so a model never has to

package/dist/runtime-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-compiler.d.ts","sourceRoot":"","sources":["../src/runtime-compiler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-compiler.d.ts","sourceRoot":"","sources":["../src/runtime-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAI5E,OAAO,EAML,KAAK,mBAAmB,EAExB,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EAGpC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,YAAY,CAAC;AAErE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAE3B,wEAAwE;AACxE,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,qEAAqE;IACrE,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,OAAO,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAClD;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,CAChB,MAAM,EAAE,6BAA6B,KAClC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACtD;AAsUD;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,2BAA2B,EACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,8BAA8B,CAAC,CAYzC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA0HhC;AA0BD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,iBAAiB,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAsC9B"}

package/dist/runtime-dimensions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Grouping and time hints for a report source (#4100): which fields read as a
+ * time axis, which one is the source's natural date, and which are worth
+ * grouping by, most useful first.
+ *
+ * Both runners' source descriptions (`describeRuntimeReportSource()`,
+ * `describeRuntimeReportMemorySource()`) carry these, so an assistant or a
+ * report builder offers "Issue date by month", "Status" and "Customer", never
+ * an id, a hash or internal bookkeeping. A source definition may declare them
+ * (`timeField`, `dimensions`); otherwise they are derived from field metadata
+ * in this order:
+ *
+ * - time fields: every datetime field except a soft-delete stamp;
+ * - the natural date: a business date (`@field({ ui: { format: 'date' } })`),
+ *   else the first datetime that is not bookkeeping (`createdAt`, `updatedAt`,
+ *   `syncedAt`, `last…At`), else `createdAt`;
+ * - groupings: closed text fields (declared `enum`) and booleans as
+ *   categories, foreign keys as relations; never `id`, free text, or a field
+ *   whose name marks it internal (`…Hash`, `…Json`, `…Token`, `…Authority`,
+ *   `…Snapshot`, `external…`, `historical…`), ranked status, then kind/type,
+ *   then people and things (customer, vendor, product), then other categories,
+ *   other relations, then flags.
+ *
+ * These are hints for choosing, not authority: a spec may still group by any
+ * field the source exposes, and the compiler's field policy is unchanged.
+ * Browser-safe: no Node built-ins, no registry.
+ */
+import type { RuntimeReportDimensionHints, RuntimeReportDimensionKind, RuntimeReportPlanField, RuntimeReportSourceDescription } from './runtime-plan.js';
+export interface RuntimeReportDimensionPlan {
+    kinds: Map<string, RuntimeReportDimensionKind>;
+    timeFields: string[];
+    defaultTimeField?: string;
+    dimensions: string[];
+}
+/**
+ * Plan the time and grouping hints for resolved fields. Declared hints that
+ * name a field this principal cannot see are dropped (the field set already
+ * hides it), never reported.
+ */
+export declare function planRuntimeReportDimensions(fields: ReadonlyMap<string, RuntimeReportPlanField>, hints?: RuntimeReportDimensionHints): RuntimeReportDimensionPlan;
+/** The described fields and grouping hints of a source with these fields. */
+export declare function describeRuntimeReportSourceFields(fields: ReadonlyMap<string, RuntimeReportPlanField>, hints?: RuntimeReportDimensionHints): Pick<RuntimeReportSourceDescription, 'fields' | 'timeFields' | 'defaultTimeField' | 'dimensions'>;
+//# sourceMappingURL=runtime-dimensions.d.ts.map

package/dist/runtime-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-dimensions.d.ts","sourceRoot":"","sources":["../src/runtime-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,8BAA8B,EAC/B,MAAM,mBAAmB,CAAC;AAgD3B,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,EACnD,KAAK,GAAE,2BAAgC,GACtC,0BAA0B,CAyD5B;AAED,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,EACnD,KAAK,GAAE,2BAAgC,GACtC,IAAI,CACL,8BAA8B,EAC9B,QAAQ,GAAG,YAAY,GAAG,kBAAkB,GAAG,YAAY,CAC5D,CAsBA"}

package/dist/runtime-memory.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Database-free runtime report runner (#4100).
+ *
+ * `runRuntimeReportInMemory()` evaluates a parsed `RuntimeReportSpec` over
+ * rows the caller already holds and returns the same `RuntimeReportResult`
+ * shape `runRuntimeReport()` returns. It shares the column, operator, value
+ * coercion and cell rules with the SQL compiler (`runtime-plan.ts`), and its
+ * SQL-shaped semantics (NULL handling, grouping, buckets, HAVING, ordering,
+ * truncation) are held to the SQL path by `runtime-memory-parity.test.ts`.
+ *
+ * It is a BROWSER PREVIEW AND TEST RUNNER, NOT AN AUTHORITY BOUNDARY. Its
+ * source descriptions are caller-supplied and carry no registry field policy,
+ * principal, RBAC or tenant: whoever hands it rows has already decided the
+ * caller may see them. Production reports still compile on the server
+ * (`compileRuntimeReportSpec()` with the live principal) and save only through
+ * `saveRuntimeReport()`.
+ */
+import { type RuntimeReportColumnType, type RuntimeReportResult, type RuntimeReportSourceDescription } from './runtime-plan.js';
+import { type RuntimeReportSpec } from './runtime-spec.js';
+/** One declared field of an in-memory source; rows are keyed by `name`. */
+export interface RuntimeReportMemoryField {
+    name: string;
+    type: RuntimeReportColumnType;
+    label?: string;
+    /**
+     * Format hint carried onto result columns (`money`), as `@field({ ui:
+     * { format } })` declares it; `date` on a datetime marks a business date.
+     */
+    format?: string;
+    /** Declared values of a closed text field (a status). */
+    enum?: readonly string[];
+}
+/**
+ * An in-memory report source: the browser counterpart of a server
+ * `RuntimeReportSourceDefinition`. `schema` declares the fields the rows
+ * carry; `fields` / `excludeFields` narrow them exactly as on the server
+ * (omitted `fields` keeps every declared field, exclusions win, unknown names
+ * reject the source). Names starting with `_` and `tenantId` are never
+ * nameable. A declared `deletedAt` field soft-deletes rows where it is set.
+ */
+export interface RuntimeReportMemorySource {
+    id: string;
+    label?: string;
+    description?: string;
+    schema: readonly RuntimeReportMemoryField[];
+    fields?: readonly string[];
+    excludeFields?: readonly string[];
+    /** The natural date "by month" buckets; derived when omitted. */
+    timeField?: string;
+    /** Fields worth grouping by, most useful first; derived when omitted. */
+    dimensions?: readonly string[];
+}
+export type RuntimeReportMemoryRow = Readonly<Record<string, unknown>>;
+export interface RunRuntimeReportInMemoryOptions {
+    /** Caller-owned allow-list; the spec reaches nothing outside it. */
+    sources: readonly RuntimeReportMemorySource[];
+    /** Host row ceiling applied on top of the spec's own limit. */
+    maxRows?: number;
+    /** Clock for `ranAt`; pass a fixed one for deterministic previews. */
+    now?: () => Date;
+}
+/**
+ * Describe what a spec may reference on an in-memory source: the browser
+ * counterpart of `describeRuntimeReportSource()` (`reports.runtime.sources`).
+ */
+export declare function describeRuntimeReportMemorySource(sources: readonly RuntimeReportMemorySource[], sourceId: string): RuntimeReportSourceDescription;
+/**
+ * Evaluate a runtime report spec over in-memory rows of its source.
+ *
+ * Validation matches the server compiler: an unknown source, a field outside
+ * the source's allow-list, a bucket on a non-datetime field, `sum` on text, an
+ * operator the field type does not admit or an uncoercible filter value all
+ * throw the same `RuntimeReportError` codes and paths. Result datetimes
+ * (buckets, datetime dimensions, `min`/`max`) are ISO-8601 UTC strings, the
+ * form PostgreSQL and DuckDB results take; SQLite returns bucket TEXT.
+ *
+ * `rows` are the rows of `spec.source`; the caller picks them. A browser
+ * preview, never an authority boundary (see the module comment).
+ */
+export declare function runRuntimeReportInMemory(input: RuntimeReportSpec, rows: readonly RuntimeReportMemoryRow[], options: RunRuntimeReportInMemoryOptions): Promise<RuntimeReportResult>;
+//# sourceMappingURL=runtime-memory.d.ts.map

package/dist/runtime-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-memory.d.ts","sourceRoot":"","sources":["../src/runtime-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAOL,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EAGpC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAOL,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAE3B,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,+BAA+B;IAC9C,oEAAoE;IACpE,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC9C,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAmDD;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,SAAS,yBAAyB,EAAE,EAC7C,QAAQ,EAAE,MAAM,GACf,8BAA8B,CAQhC;AAqPD;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,SAAS,sBAAsB,EAAE,EACvC,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAiI9B"}

package/dist/runtime-plan.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Runtime report planning rules shared by the SQL compiler and the in-memory
+ * runner (#3711, #4100).
+ *
+ * Everything here is a pure function of a parsed spec and a resolved field
+ * set: which operators and aggregates a field type admits, how filter values
+ * are coerced, how result columns are described and how cells are normalized.
+ * `compileRuntimeReportSpec()` (server, ObjectRegistry + SQL) and
+ * `runRuntimeReportInMemory()` (browser-safe) both call these, so the two
+ * paths cannot disagree about what a spec means. Browser-safe: no Node
+ * built-ins, no registry.
+ */
+import { type RuntimeReportChart, type RuntimeReportFilter, type RuntimeReportSpec } from './runtime-spec.js';
+export type RuntimeReportColumnType = 'string' | 'integer' | 'decimal' | 'boolean' | 'datetime' | 'id';
+export interface RuntimeReportColumn {
+    id: string;
+    label: string;
+    role: 'dimension' | 'measure';
+    type: RuntimeReportColumnType;
+    /** Source field this column derives from (absent for a row count). */
+    field?: string;
+    fn?: string;
+    bucket?: string;
+    /** Field format hint carried from the model (for example `money`). */
+    format?: string;
+}
+export interface RuntimeReportResult {
+    version: 1;
+    specHash: string;
+    title: string;
+    columns: RuntimeReportColumn[];
+    rows: Record<string, string | number | boolean | null>[];
+    rowCount: number;
+    /** True when more rows existed than the spec/host limit. */
+    truncated: boolean;
+    ranAt: string;
+    chart: RuntimeReportChart;
+}
+export interface RuntimeReportSourceDescription {
+    id: string;
+    label: string;
+    description?: string;
+    /** Fields the live principal may group by, filter on or aggregate. */
+    fields: {
+        name: string;
+        label: string;
+        type: RuntimeReportColumnType;
+        format?: string;
+        /** Declared values of a closed text field (a status, a kind). */
+        enum?: readonly string[];
+        /**
+         * How the field reads as a grouping, when it is a useful one: a time axis
+         * (bucket it), a category (a status, a kind, a flag) or a relation (a
+         * customer). Absent: not offered as a grouping (ids, free text, hashes,
+         * internal bookkeeping), though a spec may still name it.
+         */
+        dimension?: RuntimeReportDimensionKind;
+        filterOperators: readonly string[];
+        aggregates: readonly string[];
+    }[];
+    /** Datetime fields a report can bucket or filter by period, default first. */
+    timeFields: string[];
+    /** The source's natural date (an invoice's issue date): what "by month" buckets. */
+    defaultTimeField?: string;
+    /** Category and relation fields worth grouping by, most useful first. */
+    dimensions: string[];
+}
+/** How a field reads as a grouping; see `RuntimeReportSourceDescription`. */
+export type RuntimeReportDimensionKind = 'time' | 'category' | 'relation';
+/**
+ * Grouping hints a source definition may declare (#4100). `timeField` names
+ * the natural date; `dimensions` lists, in order, the fields worth grouping
+ * by. Both use canonical public names; unknown names reject the source.
+ * Omitted, both are derived from field metadata (`runtime-dimensions.ts`).
+ */
+export interface RuntimeReportDimensionHints {
+    timeField?: string;
+    dimensions?: readonly string[];
+}
+/** A nameable source field after every exposure rule has been applied. */
+export interface RuntimeReportPlanField {
+    name: string;
+    type: RuntimeReportColumnType;
+    format?: string;
+    label: string;
+    /** Declared values of a closed text field. */
+    enum?: readonly string[];
+    /** `@field({ ui: { format: 'date' } })`: a business date, not a timestamp. */
+    businessDate?: boolean;
+}
+export declare function humanizeRuntimeReportName(name: string): string;
+export declare function unknownRuntimeReportField(path: string, name: string): never;
+export declare const RUNTIME_REPORT_OPERATORS_BY_TYPE: Readonly<Record<RuntimeReportColumnType, readonly RuntimeReportFilter['op'][]>>;
+export declare function runtimeReportAggregatesFor(type: RuntimeReportColumnType): readonly string[];
+/** Reject an operator the field's type does not admit. */
+export declare function assertRuntimeReportFilterOperator(filter: RuntimeReportFilter, type: RuntimeReportColumnType, path: string): void;
+/** Coerce one filter value to the field's type (ids lower-cased, datetimes to `Date`). */
+export declare function coerceRuntimeReportValue(type: RuntimeReportColumnType, value: unknown, path: string): string | number | boolean | Date;
+/**
+ * Resolve a source's `fields` allow-list and `excludeFields` deny-list against
+ * the canonical names it declares. Unknown or malformed names reject the whole
+ * source (`unsupported_source`), misspelled exclusions included.
+ */
+export declare function resolveRuntimeReportFieldPolicy(source: {
+    fields?: readonly string[];
+    excludeFields?: readonly string[];
+    timeField?: string;
+    dimensions?: readonly string[];
+}, knownNames: ReadonlySet<string>): {
+    included?: Set<string>;
+    excluded?: Set<string>;
+};
+/**
+ * Validate the spec's dimensions and measures against the resolved fields and
+ * describe the result columns, dimensions first. Filters are validated by the
+ * caller, after this, so error order matches across both runners.
+ */
+export declare function planRuntimeReportColumns(spec: RuntimeReportSpec, fields: ReadonlyMap<string, RuntimeReportPlanField>): RuntimeReportColumn[];
+/** Normalize one result cell to the wire shape (safe integers, ISO datetimes). */
+export declare function normalizeRuntimeReportCell(column: RuntimeReportColumn, value: unknown): string | number | boolean | null;
+//# sourceMappingURL=runtime-plan.d.ts.map

package/dist/runtime-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-plan.d.ts","sourceRoot":"","sources":["../src/runtime-plan.ts"],"names":[],"mappings":"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"}

package/dist/runtime-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-report.d.ts","sourceRoot":"","sources":["../src/runtime-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-report.d.ts","sourceRoot":"","sources":["../src/runtime-report.ts"],"names":[],"mappings":"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"}

package/dist/runtime-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-server.d.ts","sourceRoot":"","sources":["../src/runtime-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-server.d.ts","sourceRoot":"","sources":["../src/runtime-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EACnC,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAG3B,0EAA0E;AAC1E,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,yBACf,SAAQ,6BAA6B;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC9C,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;KACjB,KAAK,OAAO,CAAC;CACf;AAED,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,KAAK;IAE7C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAMD,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EAClD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAiB3C;AAED,+EAA+E;AAC/E,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,0BAA0B,EACnC,SAAS,EAAE,sBAAsB,GAChC,2BAA2B,CAQ7B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,CAAC,EAAE,0BAA0B,GACnC,CACD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,KAC/C,OAAO,CAAC,QAAQ,CAAC,CA8MrB;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,IAAI,0BAA0B,CAK1E;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,iBAAiB,GACpB,sBAAsB,CAQxB;AAED,yEAAyE;AACzE,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,0BAA4D,GACpE,OAAO,CAAC,mBAAmB,CAAC,CA4C9B;AAED,wEAAwE;AACxE,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,CAAC,CA+BxD;AAED,6EAA6E;AAC7E,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE;IAAE,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC;IACT,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CA0DD"}

package/dist/runtime-spec-hash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Server-side stable hash of a normalized runtime report spec (#3711, #4100).
+ *
+ * Kept apart from `runtime-spec.ts` because it needs `node:crypto`: the
+ * grammar itself is browser-safe and ships on the `./spec` subpath. Browsers
+ * use `runtimeReportSpecDigest()` (Web Crypto), which yields the same hex.
+ */
+import { type RuntimeReportSpec } from './runtime-spec.js';
+/** Stable fingerprint of a NORMALIZED spec; equal specs hash equally. */
+export declare function runtimeReportSpecHash(spec: RuntimeReportSpec): string;
+//# sourceMappingURL=runtime-spec-hash.d.ts.map

package/dist/runtime-spec-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-spec-hash.d.ts","sourceRoot":"","sources":["../src/runtime-spec-hash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAIrE"}

package/dist/runtime-spec.d.ts

@@ -12,8 +12,13 @@
  * The parser accepts no authority. Nothing in a spec names a tenant, a
  * principal, a permission, a table, a column alias that is not a plain
  * identifier, or an SQL fragment.
+ *
+ * Browser-safe (#4100): this module imports no Node built-in and, of
+ * smrt-core, only the import-free `SmrtError` subpath (never the root entry),
+ * so the grammar ships on the `./spec` subpath. The `node:crypto` hash lives in
+ * `runtime-spec-hash.ts`, which only server modules import.
  */
-import { SmrtError } from '@happyvertical/smrt-core';
+import { SmrtError } from '@happyvertical/smrt-core/smrt-error';
 export declare const RUNTIME_REPORT_SPEC_VERSION: 1;
 export declare const RUNTIME_REPORT_LIMITS: Readonly<{
     maxTitleLength: 120;
@@ -120,8 +125,15 @@ export declare class RuntimeReportError extends SmrtError {
  * depend on the registry and the live principal.
  */
 export declare function parseRuntimeReportSpec(input: unknown): RuntimeReportSpec;
-/** Stable fingerprint of a NORMALIZED spec; equal specs hash equally. */
-export declare function runtimeReportSpecHash(spec: RuntimeReportSpec): string;
-/** Stable JSON text for storage (sorted keys). */
+/**
+ * Stable JSON text for storage (sorted keys). It is also the exact input of
+ * `runtimeReportSpecHash` (server) and `runtimeReportSpecDigest` (browser).
+ */
 export declare function serializeRuntimeReportSpec(spec: RuntimeReportSpec): string;
+/**
+ * Browser-safe twin of the server's `runtimeReportSpecHash`: the same SHA-256
+ * hex over the same canonical JSON, computed with Web Crypto. Asynchronous
+ * because `crypto.subtle` is; it needs a secure context (https or localhost).
+ */
+export declare function runtimeReportSpecDigest(spec: RuntimeReportSpec): Promise<string>;
 //# sourceMappingURL=runtime-spec.d.ts.map

package/dist/runtime-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-spec.d.ts","sourceRoot":"","sources":["../src/runtime-spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-spec.d.ts","sourceRoot":"","sources":["../src/runtime-spec.ts"],"names":[],"mappings":"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"}

package/dist/runtime-time.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Time language for runtime reports (#4100): "by month", "weekly", "over
+ * time", "last month", "this year", "last 90 days", "Q3".
+ *
+ * A person asks for reports in words; a spec needs a bucket and a `[from, to)`
+ * date range. These pure functions turn the words into those values against a
+ * caller-supplied `now`, so an assistant (smrt-chat, the planner) resolves
+ * time with code rather than asking a model to do date arithmetic. All dates
+ * are UTC, like the runners' buckets. Browser-safe.
+ */
+import type { RuntimeReportBucket } from './runtime-spec.js';
+/** A resolved period: `[from, to)` as `YYYY-MM-DD`, and how to name it. */
+export interface RuntimeReportTimeRange {
+    from: string;
+    to: string;
+    /** Lower-case words for a title: "last month", "Q3 2025", "last 90 days". */
+    label: string;
+}
+export interface RuntimeReportTimeIntent {
+    /** A time grouping the words ask for ("by month", "weekly", "over time"). */
+    bucket?: RuntimeReportBucket;
+    /** A period the words name ("last quarter", "Q3", "last 90 days"). */
+    range?: RuntimeReportTimeRange;
+    /** The words mention time at all (a grouping, a period or a trend). */
+    mentionsTime: boolean;
+}
+/** The bucket "over time" means for a period of this many days. */
+export declare function runtimeReportBucketForSpan(days: number | null): RuntimeReportBucket;
+/**
+ * Resolve a period phrase against `now`. Null when the words name no period
+ * (or "all time"). A quarter or month named without a year is its latest
+ * occurrence that has started: in May, "Q3" is last year's.
+ */
+export declare function resolveRuntimeReportTimeRange(phrase: string, now: Date): RuntimeReportTimeRange | null;
+/**
+ * Read a request's time words: a grouping ("by month", "weekly"; "over time"
+ * picks one from the period's length), a period, and whether time came up at
+ * all ("the date month" mentions time without naming either).
+ */
+export declare function parseRuntimeReportTime(text: string, now: Date): RuntimeReportTimeIntent;
+//# sourceMappingURL=runtime-time.d.ts.map