@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/editorial/calendar/month.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"month.d.ts","sourceRoot":"","sources":["../../../src/editorial/calendar/month.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAID,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,MAAM,CAEzD;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAG5D;AAID,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,MAAM,EAAE,CAQzD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAIhF;AAED,sBAAsB;AACtB,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,MAAM,CAMzD;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAYD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;IAC1C,0FAA0F;IAC1F,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,KAAK,KAAK,CAAA;IAChD;;;;;OAKG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAA;CAC1D;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAyB,GACrD,aAAa,CAqCf"}

package/dist/editorial/calendar/month.js

@@ -0,0 +1,120 @@
+/*
+The calendar's date arithmetic, pure so the suite can hold it. From
+forumone-2026's `admin/calendar/month.ts` (#761 there), with the site's zone
+made an argument.
+
+**Everything is placed in one zone, the site's.** An item belongs to the day it
+falls on there, so two editors in different zones see the same grid. A calendar
+day is a string key, `YYYY-MM-DD`, never a `Date`: a `Date` is an instant, and
+"which day is this instant on" is only answerable once a zone is chosen.
+`calendarClock(zone).dayKey` is the one place that choice is made.
+
+The grid is whole weeks, Sunday first, covering the month. Days are counted with
+`Date.UTC`, which has no daylight saving time, so adding a day is always
+86,400,000 ms.
+*/
+const DAY_MS = 86_400_000;
+/** `2026-10`, as the query string carries it. */
+export function monthParam({ year, month }) {
+    return `${year}-${String(month).padStart(2, '0')}`;
+}
+/** The month `delta` months from `from`. */
+export function shiftMonth(from, delta) {
+    const index = from.year * 12 + (from.month - 1) + delta;
+    return { year: Math.floor(index / 12), month: (index % 12) + 1 };
+}
+const keyOfUtc = (ms) => new Date(ms).toISOString().slice(0, 10);
+/** Every day key in the grid: whole weeks, Sunday first, covering the month. */
+export function gridDays({ year, month }) {
+    const first = Date.UTC(year, month - 1, 1);
+    const last = Date.UTC(year, month, 0);
+    const start = first - new Date(first).getUTCDay() * DAY_MS;
+    const end = last + (6 - new Date(last).getUTCDay()) * DAY_MS;
+    const days = [];
+    for (let ms = start; ms <= end; ms += DAY_MS)
+        days.push(keyOfUtc(ms));
+    return days;
+}
+/**
+ * The instants to query between so nothing on the grid is missed. No zone is
+ * more than fourteen hours from UTC, so a day either side is enough; the extra
+ * rows are dropped when items are bucketed by `dayKey`.
+ */
+export function queryRange(days) {
+    const first = Date.parse(`${days[0]}T00:00:00.000Z`) - DAY_MS;
+    const last = Date.parse(`${days[days.length - 1]}T00:00:00.000Z`) + 2 * DAY_MS;
+    return { from: new Date(first).toISOString(), to: new Date(last).toISOString() };
+}
+/** "October 2026". */
+export function monthTitle({ year, month }) {
+    return new Intl.DateTimeFormat('en-US', {
+        month: 'long',
+        year: 'numeric',
+        timeZone: 'UTC',
+    }).format(new Date(Date.UTC(year, month - 1, 1)));
+}
+/** "Thursday, October 1", for the agenda list. */
+export function dayTitle(key) {
+    return new Intl.DateTimeFormat('en-US', {
+        weekday: 'long',
+        month: 'long',
+        day: 'numeric',
+        timeZone: 'UTC',
+    }).format(new Date(`${key}T00:00:00.000Z`));
+}
+/** What follows a time: "ET". Intl's short generic name, e.g. "ET", "PT". */
+export function defaultZoneLabel(zone) {
+    const part = new Intl.DateTimeFormat('en-US', { timeZone: zone, timeZoneName: 'shortGeneric' })
+        .formatToParts(new Date(0))
+        .find((p) => p.type === 'timeZoneName');
+    return part?.value ?? zone;
+}
+function isZone(value) {
+    if (typeof value !== 'string' || value === '')
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: value });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The zone-bound half of the arithmetic. */
+export function calendarClock(zone, zoneLabel = defaultZoneLabel) {
+    if (!isZone(zone))
+        throw new Error(`calendarClock: "${zone}" is not an IANA time zone.`);
+    const keyFormat = new Intl.DateTimeFormat('en-CA', {
+        timeZone: zone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    });
+    const dayKey = (instant) => keyFormat.format(typeof instant === 'string' ? new Date(instant) : instant);
+    const clock = (instant, at) => new Intl.DateTimeFormat('en-US', { hour: 'numeric', minute: '2-digit', timeZone: at }).format(new Date(instant));
+    return {
+        zone,
+        label: zoneLabel(zone),
+        dayKey,
+        parseMonth: (param, now) => {
+            if (typeof param === 'string') {
+                const match = /^(\d{4})-(\d{2})$/.exec(param);
+                if (match) {
+                    const year = Number(match[1]);
+                    const month = Number(match[2]);
+                    if (month >= 1 && month <= 12 && year >= 2000 && year <= 2100)
+                        return { year, month };
+                }
+            }
+            const [year, month] = dayKey(now).split('-').map(Number);
+            return { year: year, month: month };
+        },
+        timeLabel: (instant, ownZone) => {
+            const site = `${clock(instant, zone)} ${zoneLabel(zone)}`;
+            if (!isZone(ownZone) || ownZone === zone)
+                return site;
+            return `${site} (${clock(instant, ownZone)} ${zoneLabel(ownZone)})`;
+        },
+    };
+}
+//# sourceMappingURL=month.js.map

package/dist/editorial/calendar/month.js.map

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

package/dist/editorial/calendar/tool.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { McpToolDescriptor } from '../../mcp/collector.js';
+import { type CalendarMonth, type CalendarOptions } from './calendar.js';
+import type { CalendarKind } from './find.js';
+export declare const CALENDAR_TOOLS: {
+    readonly getContentCalendar: {
+        readonly name: "get_content_calendar";
+        readonly description: "One month of the content calendar: scheduled publishes, past publishes and events, by day in the site's time zone. Use for \"what goes live next week?\", \"is anything scheduled on the 14th?\", or to check two launches do not collide before scheduling. Pass `month` as YYYY-MM (default: this month) and `kinds` to narrow it.";
+    };
+};
+export declare const CALENDAR_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+declare const inputSchema: z.ZodObject<{
+    month: z.ZodOptional<z.ZodString>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["scheduled", "published", "event"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    month?: string | undefined;
+    kinds?: ("published" | "event" | "scheduled")[] | undefined;
+}, {
+    month?: string | undefined;
+    kinds?: ("published" | "event" | "scheduled")[] | undefined;
+}>;
+/** The month as the tool returns it: the month's own days with anything on them. */
+export declare function toolCalendar(calendar: CalendarMonth, adminRoute: string, kinds?: readonly CalendarKind[]): {
+    month: string;
+    timeZone: string;
+    today: string;
+    total: number;
+    days: {
+        day: string;
+        items: {
+            time: string;
+            adminUrl: string;
+            kind: CalendarKind;
+            collection: string;
+            id: number | string;
+            title: string;
+            at: string;
+            zone?: string;
+            draft?: boolean;
+        }[];
+    }[];
+};
+export declare function createGetContentCalendarTool(deps: {
+    payload: Payload;
+    calendar: CalendarOptions;
+}): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/editorial/calendar/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/editorial/calendar/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAQ7C,eAAO,MAAM,cAAc;;;;;CAM2B,CAAA;AAEtD,eAAO,MAAM,yBAAyB,EAAE,SAAS,iBAAiB,EAAkC,CAAA;AAEpG,QAAA,MAAM,WAAW;;;;;;;;;EAUf,CAAA;AAEF,oFAAoF;AACpF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE;;;;;;;;;;;;;;;;;;;EAqBhC;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,eAAe,CAAA;CAC1B,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAoBxC"}

package/dist/editorial/calendar/tool.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { daysInMonth, readCalendarMonth, } from './calendar.js';
+import { monthParam } from './month.js';
+/*
+The content calendar, as an MCP tool: the same month the view reads, as the
+caller, as a list of days.
+*/
+export const CALENDAR_TOOLS = {
+    getContentCalendar: {
+        name: 'get_content_calendar',
+        description: 'One month of the content calendar: scheduled publishes, past publishes and events, by day in the site\'s time zone. Use for "what goes live next week?", "is anything scheduled on the 14th?", or to check two launches do not collide before scheduling. Pass `month` as YYYY-MM (default: this month) and `kinds` to narrow it.',
+    },
+};
+export const CALENDAR_TOOL_DESCRIPTORS = Object.values(CALENDAR_TOOLS);
+const inputSchema = z.object({
+    month: z
+        .string()
+        .regex(/^\d{4}-\d{2}$/)
+        .optional()
+        .describe('The month, as YYYY-MM. Default: the current month in the site time zone.'),
+    kinds: z
+        .array(z.enum(['scheduled', 'published', 'event']))
+        .optional()
+        .describe('Only these kinds of item. Default: all.'),
+});
+/** The month as the tool returns it: the month's own days with anything on them. */
+export function toolCalendar(calendar, adminRoute, kinds) {
+    const days = daysInMonth(calendar)
+        .map((day) => ({
+        day,
+        items: (calendar.items.get(day) ?? [])
+            .filter((item) => !kinds || kinds.includes(item.kind))
+            .map((item) => ({
+            ...item,
+            time: calendar.clock.timeLabel(item.at, item.zone),
+            adminUrl: `${adminRoute}/collections/${item.collection}/${String(item.id)}`,
+        })),
+    }))
+        .filter((day) => day.items.length > 0);
+    return {
+        month: monthParam(calendar.month),
+        timeZone: calendar.clock.zone,
+        today: calendar.today,
+        total: days.reduce((sum, day) => sum + day.items.length, 0),
+        days,
+    };
+}
+export function createGetContentCalendarTool(deps) {
+    return {
+        ...CALENDAR_TOOLS.getContentCalendar,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!ctx.user) {
+                return {
+                    error: 'Must be authenticated: the calendar is read with your own access, and an API key alone carries no identity.',
+                };
+            }
+            const calendar = await readCalendarMonth(deps.payload, {
+                calendar: deps.calendar,
+                // The same cast and the same reason as publishing's `resolvePublishingActor`.
+                user: ctx.user,
+                ...(input.month ? { month: input.month } : {}),
+            });
+            return toolCalendar(calendar, deps.payload.config.routes.admin, input.kinds);
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/editorial/calendar/tool.js.map

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

package/dist/editorial/config.d.ts

@@ -0,0 +1,25 @@
+import type { Payload, SanitizedConfig } from 'payload';
+import type { CalendarOptions } from './calendar/calendar.js';
+import type { HealthCheck } from './health/checks.js';
+import type { SearchSource } from './palette/sources.js';
+import type { WorkOptions } from './work/work.js';
+export declare const EDITORIAL_CUSTOM_KEY = "throughlineEditorial";
+export interface EditorialRuntime {
+    health?: {
+        checks: readonly HealthCheck[];
+        /** The view's path under the admin route. */
+        path: string;
+    };
+    calendar?: {
+        options: CalendarOptions;
+        path: string;
+    };
+    work?: {
+        options: WorkOptions;
+    };
+    palette?: {
+        sources: readonly SearchSource[];
+    };
+}
+export declare function editorialRuntime(config: Payload['config'] | SanitizedConfig): EditorialRuntime;
+//# sourceMappingURL=config.d.ts.map

package/dist/editorial/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/editorial/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AASjD,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;QAC9B,6CAA6C;QAC7C,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,eAAe,CAAA;QACxB,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,WAAW,CAAA;KACrB,CAAA;IACD,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;KACjC,CAAA;CACF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,eAAe,GAAG,gBAAgB,CAK9F"}

package/dist/editorial/config.js

@@ -0,0 +1,12 @@
+/*
+Where the editorial plugin leaves its configuration for its own server
+components to find. Import-map components receive no plugin options, and the
+health checks and the calendar's zone label are functions, which cannot ride on
+serialized props; `config.custom` is server-only and holds anything.
+*/
+export const EDITORIAL_CUSTOM_KEY = 'throughlineEditorial';
+export function editorialRuntime(config) {
+    return ((config.custom ?? {})[EDITORIAL_CUSTOM_KEY] ??
+        {});
+}
+//# sourceMappingURL=config.js.map

package/dist/editorial/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/editorial/config.ts"],"names":[],"mappings":"AAMA;;;;;EAKE;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAA;AAoB1D,MAAM,UAAU,gBAAgB,CAAC,MAA2C;IAC1E,OAAO,CACJ,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAkD,CAAC,oBAAoB,CAAC;QAC7F,EAAE,CACH,CAAA;AACH,CAAC"}

package/dist/editorial/health/ContentHealthReport.d.ts

@@ -0,0 +1,7 @@
+import type { HealthReport } from './find.js';
+export declare function EditorialStyles(): import("react").JSX.Element;
+export declare function ContentHealthReport({ report, adminRoute, }: {
+    report: HealthReport;
+    adminRoute: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ContentHealthReport.d.ts.map

package/dist/editorial/health/ContentHealthReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHealthReport.d.ts","sourceRoot":"","sources":["../../../src/editorial/health/ContentHealthReport.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,WAAW,CAAA;AAW1D,wBAAgB,eAAe,gCAM9B;AAyBD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,UAAU,GACX,EAAE;IACD,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB,+BAkDA"}

package/dist/editorial/health/ContentHealthReport.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { relativeTime } from '../relativeTime.js';
+import { EDITORIAL_CSS } from '../styles.js';
+import { listHref } from './checks.js';
+/*
+The content-health report, as markup. Pure: it takes the report and renders it,
+so the parity test can render exactly what an editor sees from exactly the rows
+the MCP tool returns.
+
+Each check is a section; each collection in it is a count linking to the admin
+list filtered by the same `where`, and the first rows.
+*/
+export function EditorialStyles() {
+    return (_jsx("style", { href: "throughline-editorial", precedence: "default", children: EDITORIAL_CSS }));
+}
+function Rows({ group, adminRoute, now }) {
+    return (_jsx("ul", { className: "tl-editorial__list", children: group.rows.map((row) => (_jsxs("li", { className: "tl-editorial__row", children: [_jsx("a", { href: `${adminRoute}/collections/${group.collection}/${String(row.id)}`, children: row.title }), _jsxs("span", { className: "tl-editorial__meta", children: [row.at ? (_jsxs(_Fragment, { children: ["revised ", _jsx("time", { dateTime: row.at, children: relativeTime(row.at, now) })] })) : null, row.at && row.note ? ' · ' : null, row.note ?? null] })] }, String(row.id)))) }));
+}
+export function ContentHealthReport({ report, adminRoute, }) {
+    const now = new Date(report.generatedAt);
+    return (_jsxs(_Fragment, { children: [_jsx(EditorialStyles, {}), report.checks.map((check) => {
+                const groups = check.groups.filter((group) => group.total > 0);
+                const excluded = check.groups.reduce((sum, group) => sum + (group.excluded ?? 0), 0);
+                return (_jsxs("section", { className: "tl-editorial__panel", "aria-labelledby": `tl-health-${check.id}`, children: [_jsx("h2", { id: `tl-health-${check.id}`, children: check.label }), check.description ? _jsx("p", { className: "tl-editorial__meta", children: check.description }) : null, check.skipped === 'failed' ? (_jsx("p", { className: "tl-editorial__empty", children: "This could not be checked." })) : groups.length === 0 ? (_jsx("p", { className: "tl-editorial__empty", children: check.empty })) : (groups.map((group) => (_jsxs("div", { className: "tl-health__group", children: [_jsxs("h3", { children: [group.label, ' ', _jsx("a", { href: listHref(adminRoute, group.collection, group.where), children: group.total + (group.excluded ?? 0) > group.rows.length
+                                                ? `See all ${group.total + (group.excluded ?? 0)}`
+                                                : 'Open as a list' })] }), _jsx(Rows, { group: group, adminRoute: adminRoute, now: now })] }, group.collection)))), excluded > 0 ? (_jsxs("p", { className: "tl-editorial__meta", children: [excluded, " more ", excluded === 1 ? 'is' : 'are', " not listed because nothing uses", ' ', excluded === 1 ? 'it' : 'them', "."] })) : null] }, check.id));
+            })] }));
+}
+//# sourceMappingURL=ContentHealthReport.js.map

package/dist/editorial/health/ContentHealthReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHealthReport.js","sourceRoot":"","sources":["../../../src/editorial/health/ContentHealthReport.tsx"],"names":[],"mappings":"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"}

package/dist/editorial/health/ContentHealthView.d.ts

@@ -0,0 +1,3 @@
+import type { AdminViewServerProps } from 'payload';
+export declare function ContentHealthView({ initPageResult, params, searchParams, payload, i18n, }: AdminViewServerProps): Promise<import("react").JSX.Element>;
+//# sourceMappingURL=ContentHealthView.d.ts.map

package/dist/editorial/health/ContentHealthView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHealthView.d.ts","sourceRoot":"","sources":["../../../src/editorial/health/ContentHealthView.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAcnD,wBAAsB,iBAAiB,CAAC,EACtC,cAAc,EACd,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,GACL,EAAE,oBAAoB,wCAiCtB"}

package/dist/editorial/health/ContentHealthView.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DefaultTemplate } from '@payloadcms/next/templates';
+import { Gutter } from '@payloadcms/ui';
+import { redirect } from 'next/navigation.js';
+import { editorialRuntime } from '../config.js';
+import { ContentHealthReport } from './ContentHealthReport.js';
+import { findContentNeedingAttention } from './find.js';
+/*
+`/admin/content-health`: what needs a review, and where it is. Moved from
+forumone-2026's `admin/ContentHealth.tsx` (#757 there).
+
+"Your work" answers "what is waiting on me"; this answers the question a
+content lead asks every quarter, "what is going stale?", without anybody
+building a filter. `editorialPlugin` registers it with the site's checks.
+*/
+export async function ContentHealthView({ initPageResult, params, searchParams, payload, i18n, }) {
+    const { req, permissions, locale, visibleEntities } = initPageResult;
+    // The signed-in person arrives on the request: Payload leaves the `user`
+    // prop empty for a custom root view.
+    const { user } = req;
+    const { admin } = payload.config.routes;
+    const health = editorialRuntime(payload.config).health;
+    const path = health?.path ?? '/content-health';
+    if (!user)
+        redirect(`${admin}/login?redirect=${encodeURIComponent(`${admin}${path}`)}`);
+    const report = await findContentNeedingAttention(payload, { checks: health?.checks ?? [], user });
+    return (_jsx(DefaultTemplate, { i18n: i18n, ...(locale ? { locale } : {}), ...(params ? { params } : {}), payload: payload, permissions: permissions, req: req, ...(searchParams ? { searchParams } : {}), user: user, visibleEntities: visibleEntities, children: _jsxs(Gutter, { className: "tl-health", children: [_jsx("h1", { children: "Content health" }), _jsx("p", { className: "tl-health__lede", children: "What needs a review, and where it is. Each count opens the list it counted." }), _jsx(ContentHealthReport, { report: report, adminRoute: admin })] }) }));
+}
+//# sourceMappingURL=ContentHealthView.js.map

package/dist/editorial/health/ContentHealthView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHealthView.js","sourceRoot":"","sources":["../../../src/editorial/health/ContentHealthView.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAA;AAEvD;;;;;;;EAOE;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EACtC,cAAc,EACd,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,GACiB;IACrB,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,cAAc,CAAA;IACpE,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAA;IACpB,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;IACvC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAA;IACtD,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,iBAAiB,CAAA;IAC9C,IAAI,CAAC,IAAI;QAAE,QAAQ,CAAC,GAAG,KAAK,mBAAmB,kBAAkB,CAAC,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;IAEvF,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAEjG,OAAO,CACL,KAAC,eAAe,IACd,IAAI,EAAE,IAAI,KACN,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC1B,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC9B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,GAAG,KACJ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1C,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,eAAe,YAEhC,MAAC,MAAM,IAAC,SAAS,EAAC,WAAW,aAC3B,0CAAuB,EACvB,YAAG,SAAS,EAAC,iBAAiB,4FAE1B,EACJ,KAAC,mBAAmB,IAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,GAAI,IACnD,GACO,CACnB,CAAA;AACH,CAAC"}

package/dist/editorial/health/HealthSummary.d.ts

@@ -0,0 +1,6 @@
+import type { Payload, PayloadRequest } from 'payload';
+export declare function HealthSummary({ payload, user, }: {
+    payload: Payload;
+    user: PayloadRequest['user'];
+}): Promise<import("react").JSX.Element | null>;
+//# sourceMappingURL=HealthSummary.d.ts.map

package/dist/editorial/health/HealthSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthSummary.d.ts","sourceRoot":"","sources":["../../../src/editorial/health/HealthSummary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAetD,wBAAsB,aAAa,CAAC,EAClC,OAAO,EACP,IAAI,GACL,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAC7B,+CAoDA"}

package/dist/editorial/health/HealthSummary.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { editorialRuntime } from '../config.js';
+import { EditorialStyles } from './ContentHealthReport.js';
+import { listHref } from './checks.js';
+import { findContentNeedingAttention } from './find.js';
+/*
+Content health as counts, for a dashboard: each a link to the filtered list,
+and a link to the full view. Costly checks are left to the view, because the
+dashboard is opened far more often than anybody reviews anything.
+
+A host renders it where it wants it, e.g. inside a `beforeDashboard` component:
+`<HealthSummary payload={payload} user={user} />`.
+*/
+export async function HealthSummary({ payload, user, }) {
+    if (!user)
+        return null;
+    const health = editorialRuntime(payload.config).health;
+    if (!health)
+        return null;
+    const { admin } = payload.config.routes;
+    const report = await findContentNeedingAttention(payload, {
+        checks: health.checks,
+        user,
+        scope: 'summary',
+    });
+    const line = (check) => {
+        const groups = check.groups.filter((group) => group.total > 0);
+        const total = groups.reduce((sum, group) => sum + group.total, 0);
+        return (_jsxs("li", { className: "tl-editorial__row", children: [_jsxs("span", { children: [check.label, ": ", _jsx("strong", { children: total })] }), _jsx("span", { className: "tl-editorial__meta", children: groups.length === 0
+                        ? 'none'
+                        : groups.map((group, index) => (_jsxs("span", { children: [index > 0 && ' · ', _jsxs("a", { href: listHref(admin, group.collection, group.where), children: [group.total, " ", (group.total === 1 ? group.singular : group.label).toLowerCase()] })] }, group.collection))) })] }, check.id));
+    };
+    const shown = report.checks.filter((check) => !check.skipped);
+    const left = report.checks
+        .filter((check) => check.skipped === 'costly')
+        .map((c) => c.label.toLowerCase());
+    return (_jsxs("section", { className: "tl-editorial__panel", "aria-labelledby": "tl-dashboard-health", children: [_jsx(EditorialStyles, {}), _jsx("h2", { id: "tl-dashboard-health", children: "Content health" }), _jsx("ul", { className: "tl-editorial__list", children: shown.map(line) }), _jsx("p", { className: "tl-editorial__more", children: _jsxs("a", { href: `${admin}${health.path}`, children: ["Review content health", left.length > 0 ? `, including ${left.join(' and ')}` : ''] }) })] }));
+}
+//# sourceMappingURL=HealthSummary.js.map

package/dist/editorial/health/HealthSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthSummary.js","sourceRoot":"","sources":["../../../src/editorial/health/HealthSummary.tsx"],"names":[],"mappings":"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"}

package/dist/editorial/health/checks.d.ts

@@ -0,0 +1,104 @@
+import type { CollectionSlug, Payload, Where } from 'payload';
+/** One row a check found. */
+export interface HealthRow {
+    id: number | string;
+    title: string;
+    /** The date the row is judged by, when the check has one. */
+    at?: string;
+    /** What is wrong, in a few words: "no description or image". */
+    note?: string;
+}
+export interface HealthCheck {
+    /** Stable id, used by the MCP tool's `checks` filter. */
+    id: string;
+    /** The heading: "Not revised in a year". */
+    label: string;
+    /** One sentence under the heading saying what is and is not judged. */
+    description?: string;
+    /** What to say when nothing is found. */
+    empty: string;
+    /** The collections it runs over, in display order. */
+    collections: readonly CollectionSlug[];
+    /** The query for one collection, or `null` to skip it. */
+    where: (collection: CollectionSlug, now: Date) => Where | null;
+    /** The fields `describe` and the title need. `id` is always read. */
+    select: Record<string, true>;
+    /** Database sort for the rows. Ignored when `order` is given. */
+    sort?: string;
+    /** In-memory order, for a sort no single column holds. Reads every matching row. */
+    order?: (a: HealthRow, b: HealthRow) => number;
+    /** The row's date and note. */
+    describe?: (doc: Record<string, unknown>, now: Date) => Pick<HealthRow, 'at' | 'note'>;
+    /**
+     * A second pass over every matching document, for a rule a `where` cannot
+     * state. Returns the ones that count. Implies reading every match.
+     */
+    refine?: (docs: Record<string, unknown>[], payload: Payload) => Promise<Record<string, unknown>[]>;
+    /** Too expensive for the dashboard summary: shown only on the full view and to the tool. */
+    costly?: boolean;
+}
+/** `now` minus `months` calendar months, as an ISO string. */
+export declare function monthsBefore(now: Date, months: number): string;
+export interface StaleCheckOptions {
+    /** Months without a revision after which a published document is stale, per collection. */
+    after: Readonly<Record<string, number>>;
+    /**
+     * The date fields to judge by, most trusted first. A document is dated by the
+     * first that is set. Default: `revisedAt`, `publishedAt`, `createdAt`.
+     */
+    dates?: readonly string[];
+    /** The first-publish stamp that marks a document as published in every version. Default `publishedAt`; `false` for none. */
+    publishedField?: string | false;
+    label?: string;
+    description?: string;
+    empty?: string;
+}
+/**
+ * Published documents not revised within a threshold, oldest first. A
+ * collection with no threshold is not judged: a dated post is not a stale one.
+ */
+export declare function staleCheck(options: StaleCheckOptions): HealthCheck;
+export interface MissingSeoCheckOptions {
+    collections: readonly CollectionSlug[];
+    /** Field paths. Defaults are `@payloadcms/plugin-seo`'s: `meta.description`, `meta.image`, `meta.noIndex`. */
+    fields?: {
+        description?: string;
+        image?: string;
+        noIndex?: string | false;
+    };
+    publishedField?: string | false;
+    /** Database sort. Default `-publishedAt`. */
+    sort?: string;
+    label?: string;
+    description?: string;
+    empty?: string;
+}
+/** Published, indexable documents with no meta description or no meta image. */
+export declare function missingSeoCheck(options: MissingSeoCheckOptions): HealthCheck;
+export interface MissingAltCheckOptions {
+    /** The upload collection. Default `media`. */
+    collection?: CollectionSlug;
+    /** The alt text field. Default `alt`. */
+    altField?: string;
+    /**
+     * Only images something uses. Default `true`: an unused upload is on nobody's
+     * page. Needs a full read of every document that could hold an image, so the
+     * check is `costly`.
+     */
+    onlyInUse?: boolean;
+    /** Finds the ids in use. `findReferencedIds` from `@forumone/throughline/media`. */
+    inUse?: (payload: Payload, collection: CollectionSlug) => Promise<Set<string>>;
+    label?: string;
+    description?: string;
+    empty?: string;
+}
+/** Image uploads with no alt text, by default only those something uses. */
+export declare function missingAltCheck(options?: MissingAltCheckOptions): HealthCheck;
+/**
+ * A `where` as the query string the admin list view reads, so a count links to
+ * the list it counted. Bracket notation, which is all the list view parses.
+ */
+export declare function whereQuery(where: Where): string;
+/** The admin list for `collection`, filtered by `where`. */
+export declare function listHref(adminRoute: string, collection: string, where: Where): string;
+//# sourceMappingURL=checks.d.ts.map

package/dist/editorial/health/checks.d.ts.map

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