@happyvertical/smrt-reports 0.57.5 → 0.57.7

package/dist/svelte/describe.js

@@ -0,0 +1,249 @@
+/**
+ * Words and numbers for a report, shared by every runtime-report screen (the
+ * saved-report cards, a report's page, the assistant's proposal card), so they
+ * name a report the same way: its source by label, groupings, the period with
+ * its dates, measures by their column labels, and headline figures from a run.
+ * Pure: it formats with the caller's `t`, locale and currency.
+ */
+import { formatWidgetValue } from '@happyvertical/smrt-ui/charts';
+import { reportCell } from './result.js';
+export function humanizeName(name) {
+    return name
+        .replace(/([a-z\d])([A-Z])/g, '$1 $2')
+        .replace(/[_-]+/g, ' ')
+        .trim()
+        .toLowerCase()
+        .replace(/^./, (c) => c.toUpperCase());
+}
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}(?:[T ][\d:.]+(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+function asDate(value) {
+    if (typeof value !== 'string' || !ISO_DATE.test(value))
+        return null;
+    const date = new Date(/^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00Z` : value);
+    return Number.isNaN(date.getTime()) ? null : date;
+}
+/**
+ * The spec's period: a lower (`gte`/`gt`) and/or upper (`lt`/`lte`) bound on
+ * one date field. An exclusive upper bound at midnight reads as the day
+ * before, so "last month" reads 1–31 December.
+ */
+export function reportPeriod(spec, options) {
+    const bounds = new Map();
+    spec.filters.forEach((filter, index) => {
+        const date = asDate(filter.value);
+        if (!date)
+            return;
+        const entry = bounds.get(filter.field) ?? { filters: [] };
+        if (filter.op === 'gte' || filter.op === 'gt')
+            entry.from = date;
+        else if (filter.op === 'lt' || filter.op === 'lte') {
+            const to = new Date(date);
+            const midnight = to.getUTCHours() === 0 &&
+                to.getUTCMinutes() === 0 &&
+                to.getUTCSeconds() === 0;
+            if (filter.op === 'lt' && midnight)
+                to.setUTCDate(to.getUTCDate() - 1);
+            entry.to = to;
+        }
+        else
+            return;
+        entry.filters.push(index);
+        bounds.set(filter.field, entry);
+    });
+    const [field, found] = [...bounds.entries()][0] ?? [];
+    if (!field || !found)
+        return null;
+    let tag = 'en';
+    try {
+        tag = Intl.getCanonicalLocales(options.locale)[0] ?? 'en';
+    }
+    catch {
+        // keep `en`
+    }
+    const format = new Intl.DateTimeFormat(tag, {
+        timeZone: 'UTC',
+        day: 'numeric',
+        month: 'short',
+        year: 'numeric',
+    });
+    const range = found.from && found.to
+        ? format.formatRange(found.from, found.to)
+        : found.from
+            ? options.t('reports.period.since', { date: format.format(found.from) })
+            : found.to
+                ? options.t('reports.period.until', {
+                    date: format.format(found.to),
+                })
+                : '';
+    return { field: options.label(field), range, filters: found.filters };
+}
+/** Describe a spec in the source's own words. */
+export function describeReport(spec, options) {
+    const { t, locale, currency, source, columns } = options;
+    const fieldOf = (name) => source?.fields?.find((f) => f.name === name);
+    const label = (name) => fieldOf(name)?.label ?? humanizeName(name);
+    const sourceLabel = source?.label ?? humanizeName(spec.source);
+    const groupings = spec.dimensions
+        .map((d) => d.bucket
+        ? t('reports.dimension_bucket', {
+            field: label(d.field),
+            bucket: t(`reports.bucket_unit.${d.bucket}`),
+        })
+        : label(d.field))
+        .join(', ');
+    const period = reportPeriod(spec, { locale, label, t });
+    const measures = spec.measures.map((m) => columns?.find((c) => c.id === m.as)?.label ??
+        (m.field
+            ? t(`reports.aggregate.${m.fn}`, { field: label(m.field) })
+            : t('reports.aggregate.rows', { source: sourceLabel })));
+    const value = (field, raw) => {
+        const show = (v) => fieldOf(field)?.format === 'money' && typeof v === 'number'
+            ? formatWidgetValue(v, { format: 'money', currency, locale })
+            : String(v ?? '');
+        return Array.isArray(raw) ? raw.map(show).join(', ') : show(raw);
+    };
+    const filters = spec.filters
+        .filter((_, index) => !period?.filters.includes(index))
+        .map((f) => `${label(f.field)} ${t(`reports.operator.${f.op}`)} ${value(f.field, f.value)}`.trim());
+    const measureLabel = (alias) => columns?.find((c) => c.id === alias)?.label ?? humanizeName(alias);
+    const having = spec.having.map((h) => `${measureLabel(h.measure)} ${t(`reports.operator.${h.op}`)} ${h.value}`);
+    const line = [sourceLabel, groupings, period?.range]
+        .filter((part) => Boolean(part))
+        .join(' · ');
+    return {
+        source: sourceLabel,
+        groupings,
+        period,
+        measures,
+        filters,
+        having,
+        line,
+    };
+}
+const BUCKETS = new Set([
+    'minute',
+    'hour',
+    'day',
+    'week',
+    'month',
+    'quarter',
+    'year',
+]);
+/** Does the result's x axis run over time buckets? */
+export function timeAxis(result) {
+    const x = result.chart.x
+        ? result.columns.find((c) => c.id === result.chart.x)
+        : result.columns.find((c) => c.role === 'dimension');
+    return x?.bucket && BUCKETS.has(x.bucket) ? x : undefined;
+}
+/** The measure columns a result charts, in order. */
+/** The measure columns, the charted ones (`chart.y`) first. */
+export function measureColumns(result) {
+    const measures = result.columns.filter((c) => c.role === 'measure');
+    const charted = result.chart.y ?? [];
+    return [
+        ...measures.filter((c) => charted.includes(c.id)),
+        ...measures.filter((c) => !charted.includes(c.id)),
+    ];
+}
+/** A measure's chart format. */
+export function measureFormat(column) {
+    return column.format === 'money'
+        ? 'money'
+        : column.type === 'integer'
+            ? 'integer'
+            : 'decimal';
+}
+/**
+ * Headline figures for one measure: the total (only for an additive measure:
+ * a sum or a row count), the average per group, and the peak with its group.
+ * An ungrouped report has one value, its own figure.
+ */
+export function reportFigures(result, measure, options) {
+    const { t, locale, currency } = options;
+    const values = result.rows
+        .map((row) => ({ row, value: row[measure.id] }))
+        .filter((entry) => typeof entry.value === 'number' && Number.isFinite(entry.value));
+    if (values.length === 0)
+        return [];
+    const show = (value) => reportCell(measure.type === 'integer' && !Number.isInteger(value)
+        ? Math.round(value * 100) / 100
+        : value, measure.type === 'integer' && !Number.isInteger(value)
+        ? { ...measure, type: 'decimal' }
+        : measure, locale, currency);
+    const grouped = result.columns.some((c) => c.role === 'dimension');
+    if (!grouped || values.length === 1) {
+        return [{ label: measure.label, value: show(values[0].value) }];
+    }
+    const sum = values.reduce((total, entry) => total + entry.value, 0);
+    const peak = values.reduce((best, entry) => entry.value > best.value ? entry : best);
+    const axis = timeAxis(result);
+    const figures = [];
+    if (options.fn === 'sum' || options.fn === 'count') {
+        figures.push({ label: t('reports.figure.total'), value: show(sum) });
+    }
+    figures.push({
+        label: axis?.bucket
+            ? t('reports.figure.average_per', {
+                bucket: t(`reports.bucket_unit.${axis.bucket}`),
+            })
+            : t('reports.figure.average'),
+        value: show(sum / values.length),
+    });
+    figures.push({
+        label: t('reports.figure.peak'),
+        value: show(peak.value),
+        detail: options.groupLabel(peak.row),
+    });
+    return figures;
+}
+/** "3 days ago", "in 2 hours", "just now": a time relative to `now`. */
+export function relativeTime(iso, locale, now = new Date(), 
+/** What under a minute reads as ("just now"); default the locale's "now". */
+justNow) {
+    const then = new Date(iso);
+    if (Number.isNaN(then.getTime()))
+        return iso;
+    let tag = 'en';
+    try {
+        tag = Intl.getCanonicalLocales(locale)[0] ?? 'en';
+    }
+    catch {
+        // keep `en`
+    }
+    const seconds = Math.round((then.getTime() - now.getTime()) / 1000);
+    const steps = [
+        ['year', 31_536_000],
+        ['month', 2_592_000],
+        ['week', 604_800],
+        ['day', 86_400],
+        ['hour', 3_600],
+        ['minute', 60],
+    ];
+    const format = new Intl.RelativeTimeFormat(tag, { numeric: 'auto' });
+    for (const [unit, size] of steps) {
+        if (Math.abs(seconds) >= size) {
+            return format.format(Math.round(seconds / size), unit);
+        }
+    }
+    return justNow ?? format.format(0, 'second');
+}
+/**
+ * A cell as CSV text: quoted when needed, and a text cell is never read as a
+ * formula. A number column's cell ("-$5.00", "-3") is left as a number.
+ */
+function csvCell(text, numeric = false) {
+    const safe = !numeric && /^[=+\-@\t\r]/.test(text) ? `'${text}` : text;
+    return /[",\n\r]/.test(safe) ? `"${safe.replaceAll('"', '""')}"` : safe;
+}
+/** The result as CSV with the screen's own formatting (labels, buckets, money). */
+export function reportCsv(result, cell) {
+    const lines = [
+        result.columns.map((column) => csvCell(column.label)).join(','),
+        ...result.rows.map((row) => result.columns
+            .map((column) => csvCell(cell(row[column.id], column), (column.type === 'integer' || column.type === 'decimal') &&
+            typeof row[column.id] === 'number'))
+            .join(',')),
+    ];
+    return `${lines.join('\r\n')}\r\n`;
+}

package/dist/svelte/index.d.ts

@@ -1,8 +1,9 @@
 export { getRuntimeReportsBrowserClient, type RuntimeReportsBrowserClientOptions, } from './browser-client.js';
 export { createRuntimeReportsHttpClient, type RuntimeReportsHttpClientOptions, RuntimeReportsHttpError, } from './client.js';
+export { describeReport, humanizeName, type ReportDescription, type ReportFieldInfo, type ReportFigure, type ReportPeriod, type ReportSourceInfo, relativeTime, reportCsv, reportFigures, reportPeriod, } from './describe.js';
 export { default as MaterializedReportTable } from './MaterializedReportTable.svelte';
 export type { MaterializedReportCell, MaterializedReportDrilldown, MaterializedReportPage, } from './materialized.js';
-export { default as ReportConfirmation } from './ReportConfirmation.svelte';
+export { default as ReportConfirmation, type ReportConfirmationOutcome, } from './ReportConfirmation.svelte';
 export { default as ReportDetail } from './ReportDetail.svelte';
 export { default as ReportPicker } from './ReportPicker.svelte';
 export { default as ReportResult } from './ReportResult.svelte';
@@ -11,7 +12,9 @@ export { default as RuntimeReportDetailRoute } from './RuntimeReportDetailRoute.
 export { default as RuntimeReportsRoute } from './RuntimeReportsRoute.svelte';
 export { default as RuntimeReportToolResult } from './RuntimeReportToolResult.svelte';
 export { default as RuntimeReportWidgetOptions } from './RuntimeReportWidgetOptions.svelte';
+export { default as SavedReportCard } from './SavedReportCard.svelte';
 export { default as SavedReports } from './SavedReports.svelte';
+export { default as SavedReportsWidget } from './SavedReportsWidget.svelte';
 export { runtimeReportProposalFromMessage, runtimeReportToolResultComponent, type ToolResultMessage, } from './tool-result.js';
 export type { RuntimeReportProposal, RuntimeReportResult, RuntimeReportSpec, RuntimeReportsClient, SavedRuntimeReport, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,kCAAkC,GACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,EACpC,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtF,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EACL,gCAAgC,EAChC,gCAAgC,EAChC,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,KAAK,kCAAkC,GACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,EACpC,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtF,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,OAAO,IAAI,kBAAkB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACL,gCAAgC,EAChC,gCAAgC,EAChC,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -1,7 +1,8 @@
 export { getRuntimeReportsBrowserClient, } from './browser-client.js';
 export { createRuntimeReportsHttpClient, RuntimeReportsHttpError, } from './client.js';
+export { describeReport, humanizeName, relativeTime, reportCsv, reportFigures, reportPeriod, } from './describe.js';
 export { default as MaterializedReportTable } from './MaterializedReportTable.svelte';
-export { default as ReportConfirmation } from './ReportConfirmation.svelte';
+export { default as ReportConfirmation, } from './ReportConfirmation.svelte';
 export { default as ReportDetail } from './ReportDetail.svelte';
 export { default as ReportPicker } from './ReportPicker.svelte';
 export { default as ReportResult } from './ReportResult.svelte';
@@ -10,5 +11,7 @@ export { default as RuntimeReportDetailRoute } from './RuntimeReportDetailRoute.
 export { default as RuntimeReportsRoute } from './RuntimeReportsRoute.svelte';
 export { default as RuntimeReportToolResult } from './RuntimeReportToolResult.svelte';
 export { default as RuntimeReportWidgetOptions } from './RuntimeReportWidgetOptions.svelte';
+export { default as SavedReportCard } from './SavedReportCard.svelte';
 export { default as SavedReports } from './SavedReports.svelte';
+export { default as SavedReportsWidget } from './SavedReportsWidget.svelte';
 export { runtimeReportProposalFromMessage, runtimeReportToolResultComponent, } from './tool-result.js';

package/dist/svelte/messages.d.ts

@@ -1,5 +1,44 @@
 export declare const M: {
     readonly 'reports.title': "reports.title";
+    readonly 'reports.new': "reports.new";
+    readonly 'reports.new_prompt': "reports.new_prompt";
+    readonly 'reports.hint': "reports.hint";
+    readonly 'reports.ask_where': "reports.ask_where";
+    readonly 'reports.empty_title': "reports.empty_title";
+    readonly 'reports.filter_label': "reports.filter_label";
+    readonly 'reports.filter_all': "reports.filter_all";
+    readonly 'reports.filter_mine': "reports.filter_mine";
+    readonly 'reports.archived_badge': "reports.archived_badge";
+    readonly 'reports.more': "reports.more";
+    readonly 'reports.archive_confirm_title': "reports.archive_confirm_title";
+    readonly 'reports.archive_confirm': "reports.archive_confirm";
+    readonly 'reports.restore': "reports.restore";
+    readonly 'reports.saved_at': "reports.saved_at";
+    readonly 'reports.saved_by': "reports.saved_by";
+    readonly 'reports.saved_by_at': "reports.saved_by_at";
+    readonly 'reports.ran_at': "reports.ran_at";
+    readonly 'reports.just_now': "reports.just_now";
+    readonly 'reports.period': "reports.period";
+    readonly 'reports.period.since': "reports.period.since";
+    readonly 'reports.period.until': "reports.period.until";
+    readonly 'reports.aggregate.rows': "reports.aggregate.rows";
+    readonly 'reports.figure.total': "reports.figure.total";
+    readonly 'reports.figure.average': "reports.figure.average";
+    readonly 'reports.figure.average_per': "reports.figure.average_per";
+    readonly 'reports.figure.peak': "reports.figure.peak";
+    readonly 'reports.figures': "reports.figures";
+    readonly 'reports.edit': "reports.edit";
+    readonly 'reports.edit_prompt': "reports.edit_prompt";
+    readonly 'reports.export_csv': "reports.export_csv";
+    readonly 'reports.view': "reports.view";
+    readonly 'reports.view_chart': "reports.view_chart";
+    readonly 'reports.view_table': "reports.view_table";
+    readonly 'reports.measure_pick': "reports.measure_pick";
+    readonly 'reports.view_all': "reports.view_all";
+    readonly 'reports.open_report': "reports.open_report";
+    readonly 'reports.groups_count': "reports.groups_count";
+    readonly 'reports.run_failed': "reports.run_failed";
+    readonly 'reports.details': "reports.details";
     readonly 'reports.only_mine': "reports.only_mine";
     readonly 'reports.archived': "reports.archived";
     readonly 'reports.archive': "reports.archive";
@@ -34,7 +73,16 @@ export declare const M: {
     readonly 'reports.save': "reports.save";
     readonly 'reports.confirm_title': "reports.confirm_title";
     readonly 'reports.saved': "reports.saved";
+    readonly 'reports.open': "reports.open";
     readonly 'reports.declined': "reports.declined";
+    readonly 'reports.dimension_bucket': "reports.dimension_bucket";
+    readonly 'reports.bucket_unit.minute': "reports.bucket_unit.minute";
+    readonly 'reports.bucket_unit.hour': "reports.bucket_unit.hour";
+    readonly 'reports.bucket_unit.day': "reports.bucket_unit.day";
+    readonly 'reports.bucket_unit.week': "reports.bucket_unit.week";
+    readonly 'reports.bucket_unit.month': "reports.bucket_unit.month";
+    readonly 'reports.bucket_unit.quarter': "reports.bucket_unit.quarter";
+    readonly 'reports.bucket_unit.year': "reports.bucket_unit.year";
     readonly 'reports.groupings': "reports.groupings";
     readonly 'reports.measures': "reports.measures";
     readonly 'reports.filters': "reports.filters";

package/dist/svelte/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/svelte/messages.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEZ,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/svelte/messages.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4HZ,CAAC"}

package/dist/svelte/messages.js

@@ -1,22 +1,61 @@
 import { defineMessages } from '@happyvertical/smrt-ui/i18n';
 export const M = defineMessages({
-    'reports.title': 'Reports',
+    'reports.title': 'Saved reports',
+    'reports.new': 'New report',
+    'reports.new_prompt': 'Make a report of ',
+    'reports.hint': 'Ask the assistant for a new one, for example “sales by month”.',
+    'reports.ask_where': 'Open the assistant and ask for a report, for example “sales by month”.',
+    'reports.empty_title': 'No saved reports yet',
+    'reports.filter_label': 'Whose reports',
+    'reports.filter_all': 'Everyone’s',
+    'reports.filter_mine': 'Mine',
+    'reports.archived_badge': 'Archived',
+    'reports.more': 'More actions for {title}',
+    'reports.archive_confirm_title': 'Archive “{title}”?',
+    'reports.archive_confirm': 'It leaves Saved reports for everyone on your team. You can restore it under Show archived.',
+    'reports.restore': 'Restore',
+    'reports.saved_at': 'Saved {time}',
+    'reports.saved_by': 'Saved by {author}',
+    'reports.saved_by_at': 'Saved by {author} {time}',
+    'reports.ran_at': 'Last run {time}',
+    'reports.just_now': 'just now',
+    'reports.period': 'Period',
+    'reports.period.since': 'Since {date}',
+    'reports.period.until': 'Until {date}',
+    'reports.aggregate.rows': 'Number of records',
+    'reports.figure.total': 'Total',
+    'reports.figure.average': 'Average',
+    'reports.figure.average_per': 'Average per {bucket}',
+    'reports.figure.peak': 'Peak',
+    'reports.figures': 'Headline figures',
+    'reports.edit': 'Edit',
+    'reports.edit_prompt': 'Change the report “{title}”: ',
+    'reports.export_csv': 'Export CSV',
+    'reports.view': 'Show as',
+    'reports.view_chart': 'Chart',
+    'reports.view_table': 'Table',
+    'reports.measure_pick': 'Measure',
+    'reports.view_all': 'View all saved reports',
+    'reports.open_report': 'Open report',
+    'reports.groups_count': 'Across {count} groups',
+    'reports.run_failed': 'This report could not run.',
+    'reports.details': 'Report details',
     'reports.only_mine': 'Only mine',
-    'reports.archived': 'Show archived reports',
+    'reports.archived': 'Show archived',
     'reports.archive': 'Archive',
-    'reports.unarchive': 'Unarchive',
+    'reports.unarchive': 'Restore',
     'reports.loading': 'Loading reports…',
     'reports.running': 'Running report…',
-    'reports.empty': 'No saved reports. Ask the assistant to create a report, then approve its proposal.',
-    'reports.no_rows': 'No results match this report.',
+    'reports.empty': 'Ask the assistant for a report, check its preview, and approve it. It is kept here for your team, with its numbers up to date each time you open it.',
+    'reports.no_rows': 'No matching records.',
     'reports.unavailable': 'Reports are unavailable because this host has no server.',
     'reports.error': 'The report request failed. Please try again.',
     'reports.denied': 'You do not have permission to read this report or one of its fields.',
     'reports.invalid': 'The report returned an invalid result.',
     'reports.retry': 'Try again',
     'reports.rerun': 'Re-run',
-    'reports.table': 'Table view',
-    'reports.chart': 'Chart view',
+    'reports.table': 'Table',
+    'reports.chart': 'Chart',
     'reports.source': 'Source',
     'reports.author': 'Author',
     'reports.last_run': 'Last run: {time}',
@@ -28,14 +67,23 @@ export const M = defineMessages({
     'reports.select_measure': 'Measure',
     'reports.choose_report': 'Choose a saved report',
     'reports.choose_measure': 'Choose a measure',
-    'reports.select_dimension': 'Dimension',
-    'reports.choose_dimension': 'Choose a dimension',
+    'reports.select_dimension': 'Group by',
+    'reports.choose_dimension': 'The report’s first grouping',
     'reports.options_invalid': 'Choose a report and measure before saving.',
     'reports.cancel': 'Cancel',
     'reports.save': 'Save',
     'reports.confirm_title': 'Review report proposal',
-    'reports.saved': 'Report saved.',
-    'reports.declined': 'Report declined. Nothing was saved.',
+    'reports.saved': 'Report saved',
+    'reports.open': 'Open report',
+    'reports.declined': 'Declined — nothing saved',
+    'reports.dimension_bucket': '{field} by {bucket}',
+    'reports.bucket_unit.minute': 'minute',
+    'reports.bucket_unit.hour': 'hour',
+    'reports.bucket_unit.day': 'day',
+    'reports.bucket_unit.week': 'week',
+    'reports.bucket_unit.month': 'month',
+    'reports.bucket_unit.quarter': 'quarter',
+    'reports.bucket_unit.year': 'year',
     'reports.groupings': 'Group by',
     'reports.measures': 'Measures',
     'reports.filters': 'Filters',

package/dist/svelte/playground.d.ts

@@ -101,7 +101,7 @@ declare const _default: {
         id: string;
         title: string;
         description: string;
-        loadComponent: () => Promise<import("svelte").Component<import("./ReportResult.svelte").Props, {}, "">>;
+        loadComponent: () => Promise<import("svelte").Component<import("./ReportResult.svelte").Props, {}, "view">>;
         props: {
             result: {
                 rows: never[];
@@ -109,7 +109,7 @@ declare const _default: {
                 version: 1;
                 specHash: string;
                 title: string;
-                columns: import("../runtime-compiler.js").RuntimeReportColumn[];
+                columns: import("../runtime-plan.js").RuntimeReportColumn[];
                 truncated: boolean;
                 ranAt: string;
                 chart: import("../runtime-spec.js").RuntimeReportChart;

package/dist/svelte/playground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAkEE"}
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAmEE"}

package/dist/svelte/playground.js

@@ -7,7 +7,7 @@ export 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('./SavedReports.svelte').then((m) => m.default),
             props: { client: client() },
             order: 1,

package/dist/svelte/types.d.ts

@@ -9,6 +9,8 @@ export interface SavedRuntimeReport {
     createdByUserId: string;
     status: 'active' | 'archived';
     spec: RuntimeReportSpec;
+    /** When the report was saved (approved), when the host knows it. */
+    savedAt?: string;
     /** Browser-session hint only. Runtime result rows and run history are not persisted. */
     lastRunAt?: string;
     /** Host permission hint. The archive endpoint authorizes every mutation again. */

package/dist/svelte/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/svelte/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,OAAO,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvE;AAED,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;AAEvD,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/svelte/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,OAAO,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvE;AAED,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;AAEvD,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-reports",
-  "version": "0.57.5",
+  "version": "0.57.7",
   "description": "Materialized aggregate report models for SMRT",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,6 +39,10 @@
       "types": "./dist/state.d.ts",
       "import": "./dist/state.js"
     },
+    "./spec": {
+      "types": "./dist/spec.d.ts",
+      "import": "./dist/spec.js"
+    },
     "./manifest": "./dist/manifest.json",
     "./manifest.json": "./dist/manifest.json",
     "./svelte": {
@@ -52,17 +56,17 @@
     }
   },
   "dependencies": {
-    "@happyvertical/smrt-core": "0.57.5",
-    "@happyvertical/smrt-jobs": "0.57.5",
-    "@happyvertical/smrt-types": "0.57.5",
-    "@happyvertical/smrt-tenancy": "0.57.5",
+    "@happyvertical/smrt-core": "0.57.7",
+    "@happyvertical/smrt-jobs": "0.57.7",
+    "@happyvertical/smrt-types": "0.57.7",
+    "@happyvertical/smrt-tenancy": "0.57.7",
     "@happyvertical/sql": "^0.105.2",
-    "@happyvertical/smrt-config": "0.57.5",
-    "@happyvertical/smrt-ui": "0.57.5"
+    "@happyvertical/smrt-config": "0.57.7",
+    "@happyvertical/smrt-ui": "0.57.7"
   },
   "devDependencies": {
-    "@happyvertical/smrt-scanner": "0.57.5",
-    "@happyvertical/smrt-vitest": "0.57.5",
+    "@happyvertical/smrt-scanner": "0.57.7",
+    "@happyvertical/smrt-vitest": "0.57.7",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",