@aglyn/aglyn 1.0.0-beta.262 → 1.0.0-beta.264

package/src/lib/app-utils/weekly-summary.d.ts

@@ -14,29 +14,32 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type PluginFigureCell, type PluginFigureHeadline, type PluginFigureRow, type PluginFigureTable } from '../plugin-manager/plugin-figures';
+import { type PluginFigureCell, type PluginFigureRow, type PluginFigureSummaryPart, type PluginFigureSummaryStat, type PluginFigureTable } from '../plugin-manager/plugin-figures';
 /**
- * THE WEEKLY SUMMARY (AGL-3867): the free Monday email that says how each of
- * a workspace's sites did last week, and how the workspace's own figures
- * moved.
+ * THE WEEKLY SUMMARY (AGL-3867): the free Monday emails that say how a
+ * workspace did the week before — one for each site that had something to
+ * report, and an overview of the workspace that adds the sites up.
  *
- * It spends nothing. Every figure comes from a `plugin-figures` reader that
- * declares a `weeklySummary`, and that reader's owner words its own lines, so
- * each plugin's counting rules decide what a figure is and nothing here names
- * one. AI weekly insights (AGL-2915) are the paid version that explains the
- * figures, and stay opt-in because each one spends the workspace's AI credits.
+ * They spend nothing. Every figure comes from a `plugin-figures` reader that
+ * declares a `weeklySummary`, and that reader's owner says what its table
+ * means as tiles and ranked rows, so each plugin's counting rules decide what
+ * a figure is and nothing here names one. AI weekly insights (AGL-2915) are
+ * the paid version that explains the figures, and stay opt-in because each
+ * one spends the workspace's AI credits.
  *
- * This module is the period, the shared wording helpers the readers use, and
- * the email's words; the reads and the sends are
- * `@aglyn/tenant-data-admin/server/weekly-summary`.
+ * This module is the period, the wording helpers the readers use, and both
+ * emails' words and layout; the reads and the sends are
+ * `@aglyn/tenant-data-admin/server/weekly-summary`. The layout is drawn as
+ * email-safe tables with inline styles, in colors the caller resolves from
+ * the email theme.
  */
 /** The key a person's switch is stored under in `users/{uid}.digestPrefs`; on until turned off. */
 export declare const WEEKLY_SUMMARY_DIGEST_KEY = "weeklySummary";
 /** The window every figure is read over. */
 export declare const WEEKLY_SUMMARY_DAYS = 7;
-/** Rows a ranked line names: the top three. */
-export declare const WEEKLY_SUMMARY_TOP_ROWS = 3;
-/** Counts the subject line leads with, at most. */
+/** Rows a ranked list names. */
+export declare const WEEKLY_SUMMARY_TOP_ROWS = 5;
+/** Counts a subject line or the overview's tiles lead with, at most. */
 export declare const WEEKLY_SUMMARY_HEADLINE_COUNTS = 3;
 /**
  * The week a run reports on: the seven whole UTC days before the day it runs,
@@ -58,43 +61,113 @@ export declare function figureCount(value: PluginFigureCell | undefined): number
 export declare function figureRow(table: PluginFigureTable, key: string, label: string): PluginFigureRow | undefined;
 /** Whether a table carries a column, so a reader that changed shape is noticed rather than misread. */
 export declare function figureHasColumn(table: PluginFigureTable, key: string): boolean;
-/** "1,204 (+12%)": a cell and, when there is an earlier week to compare with, its change. */
-export declare function figureWithChange(table: PluginFigureTable, row: PluginFigureRow, key: string, changeKey: string): string;
-/** The named rows with the most of `key`, as "name 12 unit, name 4"; `null` when none has any. */
-export declare function figureRanked(table: PluginFigureTable, nameKey: string, key: string, unit?: string, rows?: readonly PluginFigureRow[]): string | null;
+/** A cell as a tile, with its change when the table has one. */
+export declare function figureStat(table: PluginFigureTable, row: PluginFigureRow, key: string, label: string, options?: {
+    change?: string;
+    total?: {
+        one: string;
+        many: string;
+    };
+}): PluginFigureSummaryStat;
+/** The named rows with the most of `key`, as ranked rows; `[]` when none has any. */
+export declare function figureRanked(table: PluginFigureTable, nameKey: string, key: string, rows?: readonly PluginFigureRow[]): Array<{
+    label: string;
+    value: string;
+}>;
 /** "1 order", "18 orders". */
 export declare function figurePlural(count: number, one: string, many: string): string;
-/** What one reader said this week: its lines and the count it adds to the subject. */
-export interface WeeklySummaryEntry {
-    lines: string[];
-    headline: PluginFigureHeadline | null;
-}
-/** One site's part of the email. */
+/** One site's figures for the week. */
 export interface WeeklySummarySite {
     name: string;
     /** The site's dashboard in the console, absolute; `null` with no origin to build it from. */
     url: string | null;
-    entries: readonly WeeklySummaryEntry[];
+    /**
+     * Where the site itself is, so a reader knows which site this is: its
+     * custom domain when it serves on one, else its platform address. `null`
+     * for a site with no address yet.
+     */
+    address?: {
+        label: string;
+        url: string;
+    } | null;
+    parts: readonly PluginFigureSummaryPart[];
+}
+/** The colors an email is drawn in, resolved from its theme by the caller. */
+export interface WeeklySummaryColors {
+    text: string;
+    muted: string;
+    border: string;
+    /** A tile's ground. */
+    surface: string;
+    /** The accent rule beside a callout. */
+    accent: string;
+    /** Links: the email theme's own link color, the one every other link in the email wears. */
+    link: string;
+    /** A rise and a fall. */
+    up: string;
+    down: string;
+}
+/** A site with anything to say. */
+export declare function weeklySummaryHasNews(site: Pick<WeeklySummarySite, 'parts'>): boolean;
+/** The counts the readers offered for adding up, summed by noun, in the order they were first given. */
+export declare function weeklySummaryTotals(sites: ReadonlyArray<Pick<WeeklySummarySite, 'parts'>>): Array<{
+    count: number;
+    one: string;
+    many: string;
+}>;
+/** "+12.5%", "−27.9%", "no change"; `null` with nothing to compare with. */
+export declare function weeklySummaryChange(change: number | null | undefined): {
+    text: string;
+    sign: 1 | -1 | 0;
+} | null;
+/**
+ * How many tiles share each row: one row of up to three, two rows of two for
+ * four, then rows of three — so a row is never left with an empty slot
+ * beside two tiles.
+ */
+export declare function weeklySummaryTileRows(count: number): number[];
+/** What a send fills a weekly summary email's tokens with. */
+export interface WeeklySummaryEmail {
+    subject: string;
+    /** The heading: "Aglyn last week". */
+    title: string;
+    /** "Oct 5 – Oct 11, compared with the week before". */
+    period: string;
+    /** The figures, drawn. */
+    html: string;
+    /** The whole email as plain text, closing line included. */
+    text: string;
+    buttonLabel: string;
+    /** Where the button goes; `''` when there is no console origin to link to. */
+    url: string;
 }
-/** The subject's counts, summed across sites by their noun, in the order the readers first gave them. */
-export declare function weeklySummaryHeadline(sites: readonly WeeklySummarySite[]): string;
-export declare function composeWeeklySummarySubject(workspaceName: string, sites: readonly WeeklySummarySite[]): string;
-export interface WeeklySummaryEmailInput {
+interface CommonInput {
     workspaceName: string;
     productName: string;
     periodLabel: string;
-    sites: readonly WeeklySummarySite[];
-    /** The workspace's own figures, such as its deals. */
-    workspace: readonly WeeklySummaryEntry[];
+    colors: WeeklySummaryColors;
     /** Where AI weekly insights are turned on, when the plan includes them and this person has not; else `null`. */
     aiInsightsUrl: string | null;
     settingsUrl: string;
-    /** Drops the closing "why" line, which the designed email's footer carries. */
-    omitClosing?: boolean;
 }
 /**
- * The email's words, or `null` when there is nothing to report at all — a
- * week with no figures is not worth an email, and sending one anyway is how a
- * summary trains people to ignore it. A site with nothing to say is left out.
+ * One site's email, or `null` for a site with nothing to report. `workspace`
+ * carries the workspace's own parts when this site's email stands in for the
+ * overview, in a workspace with one active site.
  */
-export declare function composeWeeklySummaryEmailText(input: WeeklySummaryEmailInput): string | null;
+export declare function composeWeeklySummarySiteEmail(input: CommonInput & {
+    site: WeeklySummarySite;
+    workspace?: readonly PluginFigureSummaryPart[];
+}): WeeklySummaryEmail | null;
+/**
+ * The workspace overview: the week's totals across its sites, a line for each
+ * site, and the workspace's own figures, or `null` when nothing anywhere has
+ * anything to report.
+ */
+export declare function composeWeeklySummaryOverviewEmail(input: CommonInput & {
+    sites: readonly WeeklySummarySite[];
+    workspace: readonly PluginFigureSummaryPart[];
+    /** The workspace's home in the console, absolute; `''` with no origin. */
+    url: string;
+}): WeeklySummaryEmail | null;
+export {};

package/src/lib/app-utils/weekly-summary.js

@@ -16,23 +16,27 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * limitations under the License.
  */ import { pluginFigureCellText, pluginFigureIsoWeek, pluginFigureWindows } from "../plugin-manager/plugin-figures.js";
 /**
- * THE WEEKLY SUMMARY (AGL-3867): the free Monday email that says how each of
- * a workspace's sites did last week, and how the workspace's own figures
- * moved.
+ * THE WEEKLY SUMMARY (AGL-3867): the free Monday emails that say how a
+ * workspace did the week before — one for each site that had something to
+ * report, and an overview of the workspace that adds the sites up.
  *
- * It spends nothing. Every figure comes from a `plugin-figures` reader that
- * declares a `weeklySummary`, and that reader's owner words its own lines, so
- * each plugin's counting rules decide what a figure is and nothing here names
- * one. AI weekly insights (AGL-2915) are the paid version that explains the
- * figures, and stay opt-in because each one spends the workspace's AI credits.
+ * They spend nothing. Every figure comes from a `plugin-figures` reader that
+ * declares a `weeklySummary`, and that reader's owner says what its table
+ * means as tiles and ranked rows, so each plugin's counting rules decide what
+ * a figure is and nothing here names one. AI weekly insights (AGL-2915) are
+ * the paid version that explains the figures, and stay opt-in because each
+ * one spends the workspace's AI credits.
  *
- * This module is the period, the shared wording helpers the readers use, and
- * the email's words; the reads and the sends are
- * `@aglyn/tenant-data-admin/server/weekly-summary`.
+ * This module is the period, the wording helpers the readers use, and both
+ * emails' words and layout; the reads and the sends are
+ * `@aglyn/tenant-data-admin/server/weekly-summary`. The layout is drawn as
+ * email-safe tables with inline styles, in colors the caller resolves from
+ * the email theme.
  */ /** The key a person's switch is stored under in `users/{uid}.digestPrefs`; on until turned off. */ export const WEEKLY_SUMMARY_DIGEST_KEY = 'weeklySummary';
 /** The window every figure is read over. */ export const WEEKLY_SUMMARY_DAYS = 7;
-/** Rows a ranked line names: the top three. */ export const WEEKLY_SUMMARY_TOP_ROWS = 3;
-/** Counts the subject line leads with, at most. */ export const WEEKLY_SUMMARY_HEADLINE_COUNTS = 3;
+/** Rows a ranked list names. */ export const WEEKLY_SUMMARY_TOP_ROWS = 5;
+/** Counts a subject line or the overview's tiles lead with, at most. */ export const WEEKLY_SUMMARY_HEADLINE_COUNTS = 3;
+/** Tiles in one row of an email. */ const TILES_PER_ROW = 3;
 /**
  * The week a run reports on: the seven whole UTC days before the day it runs,
  * so a Monday run covers Monday to Sunday and never a part-day of today.
@@ -57,6 +61,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
         timeZone: 'UTC'
     });
 }
+// ── Helpers the readers word their parts with ──────────────────────────────
 /** A cell as a number, `0` for anything that is not one. */ export function figureCount(value) {
     return typeof value === 'number' && Number.isFinite(value) ? value : 0;
 }
@@ -66,72 +71,281 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 /** Whether a table carries a column, so a reader that changed shape is noticed rather than misread. */ export function figureHasColumn(table, key) {
     return table.columns.some((column)=>column.key === key);
 }
-/** "1,204 (+12%)": a cell and, when there is an earlier week to compare with, its change. */ export function figureWithChange(table, row, key, changeKey) {
+/** A cell as a tile, with its change when the table has one. */ export function figureStat(table, row, key, label, options = {}) {
     var _row_key;
-    const value = pluginFigureCellText(table, key, (_row_key = row[key]) != null ? _row_key : 0);
-    const change = row[changeKey];
-    if (typeof change !== 'number') return value;
-    return `${value} (${change === 0 ? 'no change' : pluginFigureCellText(table, changeKey, change)})`;
-}
-/** The named rows with the most of `key`, as "name 12 unit, name 4"; `null` when none has any. */ export function figureRanked(table, nameKey, key, unit = '', rows = table.rows) {
-    const top = rows.filter((row)=>typeof row[nameKey] === 'string' && figureCount(row[key]) > 0).slice(0, WEEKLY_SUMMARY_TOP_ROWS);
-    if (!top.length) return null;
-    return top.map((row, index)=>{
+    const change = options.change ? row[options.change] : undefined;
+    return _extends({
+        label,
+        value: pluginFigureCellText(table, key, (_row_key = row[key]) != null ? _row_key : 0)
+    }, typeof change === 'number' ? {
+        change
+    } : {}, options.total ? {
+        total: _extends({
+            count: figureCount(row[key])
+        }, options.total)
+    } : {});
+}
+/** The named rows with the most of `key`, as ranked rows; `[]` when none has any. */ export function figureRanked(table, nameKey, key, rows = table.rows) {
+    return rows.filter((row)=>typeof row[nameKey] === 'string' && figureCount(row[key]) > 0).slice(0, WEEKLY_SUMMARY_TOP_ROWS).map((row)=>{
         var _row_key;
-        const amount = pluginFigureCellText(table, key, (_row_key = row[key]) != null ? _row_key : 0);
-        return `${row[nameKey]} ${amount}${index === 0 && unit ? ` ${unit}` : ''}`;
-    }).join(', ');
+        return {
+            label: String(row[nameKey]),
+            value: pluginFigureCellText(table, key, (_row_key = row[key]) != null ? _row_key : 0)
+        };
+    });
 }
 /** "1 order", "18 orders". */ export function figurePlural(count, one, many) {
     return `${count.toLocaleString('en-US')} ${count === 1 ? one : many}`;
 }
-/** The subject's counts, summed across sites by their noun, in the order the readers first gave them. */ export function weeklySummaryHeadline(sites) {
+/** A site with anything to say. */ export function weeklySummaryHasNews(site) {
+    return site.parts.length > 0;
+}
+/** The counts the readers offered for adding up, summed by noun, in the order they were first given. */ export function weeklySummaryTotals(sites) {
     const sums = new Map();
     for (const site of sites){
-        for (const { headline } of site.entries){
-            if (!headline || headline.count <= 0) continue;
-            const sum = sums.get(headline.one);
-            sums.set(headline.one, sum ? _extends({}, sum, {
-                count: sum.count + headline.count
-            }) : _extends({}, headline));
+        for (const part of site.parts){
+            var _part_stats;
+            for (const stat of (_part_stats = part.stats) != null ? _part_stats : []){
+                if (!stat.total || stat.total.count <= 0) continue;
+                const sum = sums.get(stat.total.one);
+                sums.set(stat.total.one, sum ? _extends({}, sum, {
+                    count: sum.count + stat.total.count
+                }) : _extends({}, stat.total));
+            }
         }
     }
     return [
         ...sums.values()
-    ].slice(0, WEEKLY_SUMMARY_HEADLINE_COUNTS).map(({ count, one, many })=>figurePlural(count, one, many)).join(', ');
+    ];
 }
-export function composeWeeklySummarySubject(workspaceName, sites) {
-    const headline = weeklySummaryHeadline(sites);
-    return headline ? `Your week at ${workspaceName}: ${headline}` : `Your week at ${workspaceName}`;
+function headline(sites) {
+    return weeklySummaryTotals(sites).slice(0, WEEKLY_SUMMARY_HEADLINE_COUNTS).map(({ count, one, many })=>figurePlural(count, one, many)).join(', ');
 }
+/** "+12.5%", "−27.9%", "no change"; `null` with nothing to compare with. */ export function weeklySummaryChange(change) {
+    if (typeof change !== 'number' || !Number.isFinite(change)) return null;
+    if (change === 0) return {
+        text: 'no change',
+        sign: 0
+    };
+    const amount = Math.abs(change).toLocaleString('en-US', {
+        maximumFractionDigits: 1
+    });
+    return change > 0 ? {
+        text: `+${amount}%`,
+        sign: 1
+    } : {
+        text: `−${amount}%`,
+        sign: -1
+    };
+}
+const esc = (value)=>value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+const FONT = 'Helvetica, Arial, sans-serif';
+const capitalized = (value)=>value.charAt(0).toUpperCase() + value.slice(1);
 /**
- * The email's words, or `null` when there is nothing to report at all — a
- * week with no figures is not worth an email, and sending one anyway is how a
- * summary trains people to ignore it. A site with nothing to say is left out.
- */ export function composeWeeklySummaryEmailText(input) {
-    const sections = input.sites.map((site)=>({
-            site,
-            lines: site.entries.flatMap((entry)=>entry.lines)
-        })).filter(({ lines })=>lines.length > 0);
-    const workspaceLines = input.workspace.flatMap((entry)=>entry.lines);
-    if (!sections.length && !workspaceLines.length) return null;
-    const lines = [
-        `Here is how ${input.workspaceName} did last week, ${input.periodLabel}. ` + 'A change in brackets is against the week before.'
+ * A label that reads like an address — `www.google.com` — kept from being
+ * turned into a link by the inbox, which would draw it in the inbox's own
+ * blue beside the theme's links. A zero-width space after each dot breaks
+ * the detection and nothing a reader sees.
+ */ const unlinked = (value)=>esc(value).replace(/\./g, '.\u200b');
+function changeHtml(change, colors) {
+    const said = weeklySummaryChange(change);
+    if (!said) return '';
+    const color = said.sign > 0 ? colors.up : said.sign < 0 ? colors.down : colors.muted;
+    const arrow = said.sign > 0 ? '▲ ' : said.sign < 0 ? '▼ ' : '';
+    return `<div style="font-family:${FONT};font-size:13px;line-height:1.4;font-weight:600;color:${color};">${arrow}${esc(said.text)}</div>`;
+}
+/**
+ * How many tiles share each row: one row of up to three, two rows of two for
+ * four, then rows of three — so a row is never left with an empty slot
+ * beside two tiles.
+ */ export function weeklySummaryTileRows(count) {
+    if (count <= 0) return [];
+    if (count <= TILES_PER_ROW) return [
+        count
     ];
-    for (const { site, lines: siteLines } of sections){
-        lines.push('', site.name, ...siteLines.map((line)=>`- ${line}`));
-        if (site.url) lines.push(`Open this site in ${input.productName}: ${site.url}`);
-    }
-    if (workspaceLines.length) {
-        lines.push('', `Across ${input.workspaceName}`, ...workspaceLines.map((line)=>`- ${line}`));
-    }
-    if (input.aiInsightsUrl) {
-        lines.push('', `Want to know why the numbers moved? AI weekly insights explain each site's figures every Monday. ` + `Turn them on from Ask about your numbers on a site's Analytics page: ${input.aiInsightsUrl}`);
+    if (count === 4) return [
+        2,
+        2
+    ];
+    const rows = [];
+    for(let left = count; left > 0; left -= TILES_PER_ROW)rows.push(Math.min(TILES_PER_ROW, left));
+    return rows;
+}
+/** Tiles, each a value, its label and its change, filling the width of their row. */ function tilesHtml(stats, colors) {
+    const rows = [];
+    let at = 0;
+    for (const size of weeklySummaryTileRows(stats.length)){
+        const cells = stats.slice(at, at + size);
+        at += size;
+        // A tile alone takes half the row, not all of it, so it reads as a tile.
+        const columns = Math.max(size, 2);
+        const width = `${Math.floor(100 / columns)}%`;
+        const tds = cells.map((stat, index)=>{
+            // The gutter is split between neighbours, so the row's outer tiles sit
+            // flush with the column's edges.
+            const left = index === 0 ? 0 : 4;
+            const right = index === cells.length - 1 ? 0 : 4;
+            return `<td style="width:${width};padding:0 ${right}px 8px ${left}px;vertical-align:top;">` + `<div style="background-color:${colors.surface};border:1px solid ${colors.border};border-radius:8px;padding:12px 14px;">` + `<div style="font-family:${FONT};font-size:24px;line-height:1.2;font-weight:700;color:${colors.text};">${esc(stat.value)}</div>` + `<div style="font-family:${FONT};font-size:13px;line-height:1.4;color:${colors.muted};">${esc(stat.label)}</div>` + changeHtml(stat.change, colors) + `</div></td>`;
+        });
+        while(tds.length < columns)tds.push(`<td style="width:${width};padding:0 0 8px 4px;"></td>`);
+        rows.push(`<tr>${tds.join('')}</tr>`);
     }
-    if (!input.omitClosing) {
-        lines.push('', `You get this summary because you manage ${input.workspaceName}. Turn it off in Notifications: ${input.settingsUrl}`);
+    return `<table role="presentation" style="width:100%;border-collapse:collapse;table-layout:fixed;">${rows.join('')}</table>`;
+}
+/** A ranked list: the label left, its figure right, a hairline between. */ function rowsHtml(rows, colors) {
+    const trs = rows.map((row, index)=>`<tr>` + `<td style="font-family:${FONT};font-size:14px;line-height:1.4;color:${colors.text};padding:8px 12px 8px 0;` + `${index < rows.length - 1 ? `border-bottom:1px solid ${colors.border};` : ''}word-break:break-word;">${unlinked(row.label)}</td>` + `<td style="font-family:${FONT};font-size:14px;line-height:1.4;font-weight:600;color:${colors.text};padding:8px 0;text-align:right;white-space:nowrap;` + `${index < rows.length - 1 ? `border-bottom:1px solid ${colors.border};` : ''}">${esc(row.value)}</td>` + `</tr>`);
+    return `<table role="presentation" style="width:100%;border-collapse:collapse;">${trs.join('')}</table>`;
+}
+function sectionTitleHtml(title, colors) {
+    return `<div style="font-family:${FONT};font-size:12px;line-height:1.4;font-weight:700;letter-spacing:0.06em;` + `text-transform:uppercase;color:${colors.muted};padding:0 0 8px;">${esc(title)}</div>`;
+}
+function partHtml(part, colors) {
+    var _part_stats, _part_rows;
+    return `<div style="padding:16px 0 8px;">` + sectionTitleHtml(part.title, colors) + (part.note ? `<div style="font-family:${FONT};font-size:13px;line-height:1.5;color:${colors.muted};padding:0 0 8px;">${esc(part.note)}</div>` : '') + (((_part_stats = part.stats) == null ? void 0 : _part_stats.length) ? tilesHtml(part.stats, colors) : '') + (((_part_rows = part.rows) == null ? void 0 : _part_rows.length) ? rowsHtml(part.rows, colors) : '') + `</div>`;
+}
+/** "aglyn.com · Aglyn LLC": which site, linked, and whose. */ function addressHtml(site, workspaceName, colors) {
+    const address = site.address ? `<a href="${esc(site.address.url)}" style="color:${colors.link};text-decoration:underline;font-weight:600;">${esc(site.address.label)}</a>` : `<span style="font-weight:600;">${esc(site.name)}</span>`;
+    return `<div style="font-family:${FONT};font-size:14px;line-height:1.5;color:${colors.muted};padding:0 0 4px;">` + `${address} · ${esc(workspaceName)}</div>`;
+}
+function insightsHtml(url, colors) {
+    return `<div style="margin:16px 0 0;background-color:${colors.surface};border-left:3px solid ${colors.accent};border-radius:4px;padding:14px 16px;">` + `<div style="font-family:${FONT};font-size:14px;line-height:1.5;font-weight:700;color:${colors.text};">Want to know why the numbers moved?</div>` + `<div style="font-family:${FONT};font-size:14px;line-height:1.5;color:${colors.text};">` + `AI weekly insights explain each site's week in a few plain sentences. ` + `<a href="${esc(url)}" style="color:${colors.link};text-decoration:underline;">Turn them on from Ask about your numbers</a>.` + `</div></div>`;
+}
+function partText(part) {
+    var _part_stats, _part_rows;
+    const lines = [
+        part.title.toUpperCase()
+    ];
+    if (part.note) lines.push(part.note);
+    for (const stat of (_part_stats = part.stats) != null ? _part_stats : []){
+        const said = weeklySummaryChange(stat.change);
+        lines.push(`${stat.label}: ${stat.value}${said ? ` (${said.text})` : ''}`);
     }
-    return lines.join('\n');
+    for (const row of (_part_rows = part.rows) != null ? _part_rows : [])lines.push(`- ${row.label}: ${row.value}`);
+    return lines;
+}
+function closing(input) {
+    return [
+        '',
+        `You get this summary because you manage ${input.workspaceName}. Turn it off in Notifications: ${input.settingsUrl}`
+    ];
+}
+/**
+ * One site's email, or `null` for a site with nothing to report. `workspace`
+ * carries the workspace's own parts when this site's email stands in for the
+ * overview, in a workspace with one active site.
+ */ export function composeWeeklySummarySiteEmail(input) {
+    var _input_workspace, _input_site_url;
+    const workspace = (_input_workspace = input.workspace) != null ? _input_workspace : [];
+    if (!weeklySummaryHasNews(input.site) && !workspace.length) return null;
+    const lead = headline([
+        input.site
+    ]);
+    const subject = lead ? `${input.site.name} last week: ${lead}` : `${input.site.name} last week`;
+    const html = addressHtml(input.site, input.workspaceName, input.colors) + input.site.parts.map((part)=>partHtml(part, input.colors)).join('') + (workspace.length ? `<div style="border-top:1px solid ${input.colors.border};margin:16px 0 0;"></div>` + workspace.map((part)=>partHtml(_extends({}, part, {
+            title: `${input.workspaceName} · ${part.title}`
+        }), input.colors)).join('') : '') + (input.aiInsightsUrl ? insightsHtml(input.aiInsightsUrl, input.colors) : '');
+    const text = [
+        `${input.site.name} last week, ${input.periodLabel}. A change in brackets is against the week before.`,
+        `Site: ${input.site.address ? `${input.site.address.label} (${input.site.address.url})` : input.site.name} · ${input.workspaceName}`,
+        ...input.site.parts.flatMap((part)=>[
+                '',
+                ...partText(part)
+            ]),
+        ...workspace.flatMap((part)=>[
+                '',
+                ...partText(_extends({}, part, {
+                    title: `${input.workspaceName} · ${part.title}`
+                }))
+            ]),
+        ...input.site.url ? [
+            '',
+            `Open ${input.site.name} in ${input.productName}: ${input.site.url}`
+        ] : [],
+        ...input.aiInsightsUrl ? [
+            '',
+            `Want to know why the numbers moved? Turn on AI weekly insights from Ask about your numbers: ${input.aiInsightsUrl}`
+        ] : [],
+        ...closing(input)
+    ].join('\n');
+    return {
+        subject,
+        title: `${input.site.name} last week`,
+        period: `${input.periodLabel}, compared with the week before`,
+        html,
+        text,
+        buttonLabel: `Open ${input.site.name}`,
+        url: (_input_site_url = input.site.url) != null ? _input_site_url : ''
+    };
+}
+/**
+ * The workspace overview: the week's totals across its sites, a line for each
+ * site, and the workspace's own figures, or `null` when nothing anywhere has
+ * anything to report.
+ */ export function composeWeeklySummaryOverviewEmail(input) {
+    const active = input.sites.filter(weeklySummaryHasNews);
+    if (!active.length && !input.workspace.length) return null;
+    const totals = weeklySummaryTotals(active);
+    const lead = totals.slice(0, WEEKLY_SUMMARY_HEADLINE_COUNTS).map(({ count, one, many })=>figurePlural(count, one, many)).join(', ');
+    const subject = lead ? `Your week at ${input.workspaceName}: ${lead}` : `Your week at ${input.workspaceName}`;
+    const { colors } = input;
+    const totalsPart = totals.length ? {
+        title: active.length === 1 ? 'At a glance' : `Across ${active.length} sites`,
+        stats: totals.slice(0, TILES_PER_ROW * 2).map(({ count, one, many })=>({
+                label: capitalized(count === 1 ? one : many),
+                value: count.toLocaleString('en-US')
+            }))
+    } : null;
+    const siteLine = (site)=>site.parts.flatMap((part)=>{
+            var _part_stats;
+            return (_part_stats = part.stats) != null ? _part_stats : [];
+        }).filter((stat)=>stat.total && stat.total.count > 0).slice(0, WEEKLY_SUMMARY_HEADLINE_COUNTS).map((stat)=>{
+            const total = stat.total;
+            const said = weeklySummaryChange(stat.change);
+            return `${figurePlural(total.count, total.one, total.many)}${said ? ` (${said.text})` : ''}`;
+        }).join(' · ');
+    const quietCount = input.sites.length - active.length;
+    const quiet = quietCount ? `${figurePlural(quietCount, 'other site', 'other sites')} had nothing to report.` : '';
+    const sitesHtml = active.length ? `<div style="padding:16px 0 8px;">` + sectionTitleHtml('Your sites', colors) + `<table role="presentation" style="width:100%;border-collapse:collapse;">` + active.map((site, index)=>{
+        const border = index < active.length - 1 ? `border-bottom:1px solid ${colors.border};` : '';
+        const name = site.url ? `<a href="${esc(site.url)}" style="color:${colors.link};text-decoration:none;font-weight:700;">${esc(site.name)}</a>` : `<span style="font-weight:700;">${esc(site.name)}</span>`;
+        const line = siteLine(site);
+        const address = site.address ? ` <a href="${esc(site.address.url)}" style="color:${colors.muted};text-decoration:underline;font-size:13px;font-weight:400;">${esc(site.address.label)}</a>` : '';
+        return `<tr><td style="font-family:${FONT};font-size:15px;line-height:1.4;color:${colors.text};padding:10px 0;${border}">` + name + address + (line ? `<div style="font-size:13px;line-height:1.5;color:${colors.muted};">${esc(line)}</div>` : '') + `</td></tr>`;
+    }).join('') + `</table>` + (quiet ? `<div style="font-family:${FONT};font-size:13px;line-height:1.5;color:${colors.muted};padding:4px 0 0;">${esc(quiet)}</div>` : '') + `</div>` : '';
+    const html = (totalsPart ? partHtml(totalsPart, colors) : '') + sitesHtml + input.workspace.map((part)=>partHtml(part, colors)).join('') + (active.length > 1 ? `<div style="font-family:${FONT};font-size:13px;line-height:1.5;color:${colors.muted};padding:8px 0 0;">Each site's own summary arrives beside this one.</div>` : '') + (input.aiInsightsUrl ? insightsHtml(input.aiInsightsUrl, colors) : '');
+    const text = [
+        `Here is how ${input.workspaceName} did last week, ${input.periodLabel}. A change in brackets is against the week before.`,
+        ...totalsPart ? [
+            '',
+            ...partText(totalsPart)
+        ] : [],
+        ...active.length ? [
+            '',
+            'YOUR SITES',
+            ...active.map((site)=>`- ${site.name}${site.address ? ` (${site.address.label})` : ''}: ${siteLine(site) || 'see its summary'}` + (site.url ? ` · ${site.url}` : '')),
+            ...quiet ? [
+                quiet
+            ] : []
+        ] : [],
+        ...input.workspace.flatMap((part)=>[
+                '',
+                ...partText(part)
+            ]),
+        ...input.aiInsightsUrl ? [
+            '',
+            `Want to know why the numbers moved? Turn on AI weekly insights from Ask about your numbers: ${input.aiInsightsUrl}`
+        ] : [],
+        ...closing(input)
+    ].join('\n');
+    return {
+        subject,
+        title: `${input.workspaceName} last week`,
+        period: `${input.periodLabel}, compared with the week before`,
+        html,
+        text,
+        buttonLabel: `Open ${input.workspaceName}`,
+        url: input.url
+    };
 }
 
 //# sourceMappingURL=weekly-summary.js.map