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

package/dist/components/tools/validate-composition.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { auditContext } from '../../mcp/audit-context.js';
+import { withMeta } from '../../mcp/meta.js';
+import { validateComposition } from '../validation/composition.js';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createValidateCompositionTool(deps) {
+    const inputSchema = withMeta({
+        blocks: z
+            .array(z.object({
+            type: z.string(),
+            variant: z.string().optional(),
+        }))
+            .min(1),
+    });
+    return {
+        ...COMPONENTS_TOOLS.validateComposition,
+        inputSchema,
+        handler: async (input, ctx) => {
+            const manifest = await deps.loader.get();
+            const result = validateComposition({ blocks: input.blocks }, manifest);
+            await deps.auditWriter({
+                ...auditContext(ctx, input._meta),
+                action: 'design.validate',
+                mcpServer: 'component',
+                mcpTool: 'validate_composition',
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=validate-composition.js.map

package/dist/components/tools/validate-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-composition.js","sourceRoot":"","sources":["../../../src/components/tools/validate-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAOnD,MAAM,UAAU,6BAA6B,CAAC,IAA6B;IACzE,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,MAAM,EAAE,CAAC;aACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;KACV,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,gBAAgB,CAAC,mBAAmB;QACvC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;YACxC,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAA;YAEtE,MAAM,IAAI,CAAC,WAAW,CAAC;gBACrB,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC;gBACjC,MAAM,EAAE,iBAAiB;gBACzB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,sBAAsB;aAChC,CAAC,CAAA;YAEF,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/components/validation/composition.d.ts

@@ -0,0 +1,38 @@
+import type { LoadedManifest } from '@forumone/throughline-design-contract';
+export interface CompositionBlock {
+    type: string;
+    variant?: string;
+}
+export interface CompositionInput {
+    blocks: CompositionBlock[];
+}
+export interface CompositionIssue {
+    severity: 'error' | 'warning';
+    rule: string;
+    message: string;
+    blockIndex?: number;
+}
+export interface CompositionResult {
+    valid: boolean;
+    issues: CompositionIssue[];
+}
+export interface AntiPatternMatch {
+    pattern: string;
+    why: string;
+    useInstead?: string | undefined;
+    blockIndex: number;
+}
+/**
+ * Validates a proposed page layout against the design system's composition
+ * rules: forbiddenAdjacent, maxPerPage, requiredSiblings, unknown components,
+ * unknown variants. Errors block; warnings advise.
+ */
+export declare function validateComposition(input: CompositionInput, manifest: LoadedManifest): CompositionResult;
+/**
+ * Surfaces structural anti-patterns inferred from each component's
+ * `antiExamples` plus position-aware heuristics. The current rule set is
+ * intentionally small and explicit; new rules should be added with care
+ * since false positives are worse than missed detections here.
+ */
+export declare function findAntiPatterns(input: CompositionInput, manifest: LoadedManifest): AntiPatternMatch[];
+//# sourceMappingURL=composition.d.ts.map

package/dist/components/validation/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../src/components/validation/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,cAAc,GACvB,iBAAiB,CA+EnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,cAAc,GACvB,gBAAgB,EAAE,CAmDpB"}

package/dist/components/validation/composition.js

@@ -0,0 +1,135 @@
+/**
+ * Validates a proposed page layout against the design system's composition
+ * rules: forbiddenAdjacent, maxPerPage, requiredSiblings, unknown components,
+ * unknown variants. Errors block; warnings advise.
+ */
+export function validateComposition(input, manifest) {
+    const issues = [];
+    const counts = new Map();
+    for (let i = 0; i < input.blocks.length; i++) {
+        const block = input.blocks[i];
+        if (!block)
+            continue;
+        counts.set(block.type, (counts.get(block.type) ?? 0) + 1);
+        const contract = manifest.getComponent(block.type);
+        if (!contract) {
+            issues.push({
+                severity: 'error',
+                rule: 'unknown-component',
+                message: `Unknown component "${block.type}". Not present in the design system.`,
+                blockIndex: i,
+            });
+            continue;
+        }
+        if (block.variant && contract.content.variants) {
+            const has = contract.content.variants.some((v) => v.name === block.variant);
+            if (!has) {
+                issues.push({
+                    severity: 'error',
+                    rule: 'unknown-variant',
+                    message: `Component "${block.type}" does not have variant "${block.variant}"`,
+                    blockIndex: i,
+                });
+            }
+        }
+        const prev = i > 0 ? input.blocks[i - 1] : undefined;
+        const next = i < input.blocks.length - 1 ? input.blocks[i + 1] : undefined;
+        for (const forbidden of contract.composition.forbiddenAdjacent) {
+            if (prev?.type === forbidden) {
+                issues.push({
+                    severity: 'error',
+                    rule: 'forbidden-adjacent',
+                    message: `"${block.type}" cannot appear directly after "${forbidden}"`,
+                    blockIndex: i,
+                });
+            }
+            if (next?.type === forbidden) {
+                issues.push({
+                    severity: 'error',
+                    rule: 'forbidden-adjacent',
+                    message: `"${block.type}" cannot appear directly before "${forbidden}"`,
+                    blockIndex: i,
+                });
+            }
+        }
+    }
+    for (const [type, count] of counts) {
+        const contract = manifest.getComponent(type);
+        if (!contract)
+            continue;
+        const max = contract.composition.maxPerPage;
+        if (max !== null && count > max) {
+            issues.push({
+                severity: 'error',
+                rule: 'max-per-page',
+                message: `Component "${type}" appears ${count} times but the maximum allowed is ${max}`,
+            });
+        }
+        for (const required of contract.composition.requiredSiblings) {
+            if (!counts.has(required)) {
+                issues.push({
+                    severity: 'warning',
+                    rule: 'required-sibling-missing',
+                    message: `Component "${type}" expects a sibling "${required}" but none is present`,
+                });
+            }
+        }
+    }
+    return { valid: issues.every((issue) => issue.severity !== 'error'), issues };
+}
+/**
+ * Surfaces structural anti-patterns inferred from each component's
+ * `antiExamples` plus position-aware heuristics. The current rule set is
+ * intentionally small and explicit; new rules should be added with care
+ * since false positives are worse than missed detections here.
+ */
+export function findAntiPatterns(input, manifest) {
+    const matches = [];
+    const counts = new Map();
+    for (const block of input.blocks) {
+        counts.set(block.type, (counts.get(block.type) ?? 0) + 1);
+    }
+    for (let i = 0; i < input.blocks.length; i++) {
+        const block = input.blocks[i];
+        if (!block)
+            continue;
+        const contract = manifest.getComponent(block.type);
+        if (!contract)
+            continue;
+        const isLast = i === input.blocks.length - 1;
+        for (const anti of contract.antiExamples) {
+            const labelLower = anti.label.toLowerCase();
+            const isMultiplePattern = labelLower.includes('multiple') || labelLower.includes('two') || labelLower.includes('stacked');
+            if (isMultiplePattern && (counts.get(block.type) ?? 0) > 1) {
+                matches.push({
+                    pattern: anti.label,
+                    why: anti.why,
+                    useInstead: anti.useInstead,
+                    blockIndex: i,
+                });
+                continue;
+            }
+            const isEndOfPagePattern = labelLower.includes('end of') ||
+                labelLower.includes('bottom') ||
+                labelLower.includes('closer');
+            if (isEndOfPagePattern && isLast && contract.composition.placement.includes('page')) {
+                matches.push({
+                    pattern: anti.label,
+                    why: anti.why,
+                    useInstead: anti.useInstead,
+                    blockIndex: i,
+                });
+            }
+        }
+    }
+    // De-duplicate (same blockIndex + pattern can fire twice if both branches match)
+    const seen = new Set();
+    return matches.filter((m) => {
+        const key = `${m.blockIndex}:${m.pattern}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=composition.js.map

package/dist/components/validation/composition.js.map

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

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

@@ -0,0 +1,9 @@
+import { type CalendarMonth } from './calendar.js';
+export declare function ContentCalendarReport({ calendar, view, here, adminRoute, }: {
+    calendar: CalendarMonth;
+    view: 'grid' | 'list';
+    /** The view's own URL, for month and view links. */
+    here: string;
+    adminRoute: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ContentCalendarReport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentCalendarReport.d.ts","sourceRoot":"","sources":["../../../src/editorial/calendar/ContentCalendarReport.tsx"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAyB/D,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,UAAU,GACX,EAAE;IACD,QAAQ,EAAE,aAAa,CAAA;IACvB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB,+BA0HA"}

package/dist/editorial/calendar/ContentCalendarReport.js

@@ -0,0 +1,47 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { EditorialStyles } from '../health/ContentHealthReport.js';
+import { daysInMonth } from './calendar.js';
+import { dayTitle, monthParam, monthTitle, shiftMonth } from './month.js';
+/*
+The content calendar, as markup. Pure: it takes a month already read and
+renders it, so the parity test can render exactly what an editor sees from
+exactly the items the tool returns. From forumone-2026's
+`admin/ContentCalendar.tsx` (#761 there).
+
+A grid, or `?view=list` for the same month as an agenda, which reads better on a
+phone and with a screen reader. Kinds differ by border style as well as colour.
+*/
+const KIND_LABEL = {
+    scheduled: 'Scheduled',
+    published: 'Published',
+    event: 'Event',
+};
+/** Items drawn in one grid cell before the rest collapse into "+N more". */
+const PER_CELL = 4;
+const WEEKDAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+export function ContentCalendarReport({ calendar, view, here, adminRoute, }) {
+    const { month, days, items, today, clock } = calendar;
+    const inMonth = new Set(daysInMonth(calendar));
+    const href = (target, targetView = view) => `${here}?month=${monthParam(target)}${targetView === 'list' ? '&view=list' : ''}`;
+    const docHref = (item) => `${adminRoute}/collections/${item.collection}/${String(item.id)}`;
+    const describe = (item) => `${KIND_LABEL[item.kind]}${item.draft ? ' (draft)' : ''} · ${clock.timeLabel(item.at, item.zone)}`;
+    const keyOf = (item) => `${item.kind}:${item.collection}:${String(item.id)}`;
+    const chip = (item) => (_jsxs("a", { className: `tl-calendar__item tl-calendar__item--${item.kind}`, href: docHref(item), title: `${item.title} — ${describe(item)}`, children: [_jsxs("span", { className: "tl-calendar__kind", children: [KIND_LABEL[item.kind], ": "] }), item.title] }, keyOf(item)));
+    const monthDays = days.filter((key) => inMonth.has(key));
+    const count = monthDays.reduce((sum, key) => sum + (items.get(key)?.length ?? 0), 0);
+    return (_jsxs(_Fragment, { children: [_jsx(EditorialStyles, {}), _jsxs("div", { className: "tl-calendar__header", children: [_jsx("h1", { children: monthTitle(month) }), _jsxs("nav", { className: "tl-calendar__controls", "aria-label": "Month", children: [_jsx("a", { href: href(shiftMonth(month, -1)), children: "\u2190 Previous" }), _jsx("a", { href: href(clock.parseMonth(undefined, new Date())), children: "Today" }), _jsx("a", { href: href(shiftMonth(month, 1)), children: "Next \u2192" }), _jsx("span", { "aria-hidden": "true", children: "|" }), view === 'grid' ? (_jsx("a", { href: href(month, 'list'), children: "List" })) : (_jsx("a", { href: href(month, 'grid'), children: "Grid" }))] })] }), _jsxs("p", { className: "tl-calendar__legend", children: [_jsx("span", { className: "tl-calendar__item tl-calendar__item--scheduled", children: "Scheduled publish" }), _jsx("span", { className: "tl-calendar__item tl-calendar__item--published", children: "Published" }), _jsx("span", { className: "tl-calendar__item tl-calendar__item--event", children: "Event" }), _jsxs("span", { className: "tl-editorial__meta", children: ["Times are ", clock.label, ", the site\u2019s time zone."] })] }), view === 'grid' ? (_jsxs("table", { className: "tl-calendar__grid", children: [_jsxs("caption", { className: "tl-calendar__caption", children: [monthTitle(month), ": ", count, " ", count === 1 ? 'item' : 'items'] }), _jsx("thead", { children: _jsx("tr", { children: WEEKDAYS.map((day) => (_jsx("th", { scope: "col", children: day }, day))) }) }), _jsx("tbody", { children: Array.from({ length: days.length / 7 }, (_, week) => (_jsx("tr", { children: days.slice(week * 7, week * 7 + 7).map((key) => {
+                                const list = items.get(key) ?? [];
+                                const classes = ['tl-calendar__day'];
+                                if (!inMonth.has(key))
+                                    classes.push('tl-calendar__day--outside');
+                                if (key === today)
+                                    classes.push('tl-calendar__day--today');
+                                return (_jsxs("td", { className: classes.join(' '), children: [_jsxs("span", { className: "tl-calendar__date", children: [Number(key.slice(8)), key === today && _jsx("span", { className: "tl-calendar__kind", children: " (today)" })] }), list.slice(0, PER_CELL).map(chip), list.length > PER_CELL && (_jsxs("a", { className: "tl-calendar__more", href: `${href(month, 'list')}#day-${key}`, children: ["+", list.length - PER_CELL, " more"] }))] }, key));
+                            }) }, week))) })] })) : count === 0 ? (_jsx("p", { className: "tl-editorial__empty", children: "Nothing is scheduled, published or happening this month." })) : (monthDays.map((key) => {
+                const list = items.get(key) ?? [];
+                if (list.length === 0)
+                    return null;
+                return (_jsxs("section", { id: `day-${key}`, className: "tl-editorial__panel", children: [_jsxs("h2", { children: [dayTitle(key), key === today ? ' (today)' : ''] }), _jsx("ul", { className: "tl-editorial__list", children: list.map((item) => (_jsxs("li", { className: "tl-editorial__row", children: [_jsx("a", { href: docHref(item), children: item.title }), _jsx("span", { className: "tl-editorial__meta", children: describe(item) })] }, keyOf(item)))) })] }, key));
+            }))] }));
+}
+//# sourceMappingURL=ContentCalendarReport.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentCalendarView.d.ts","sourceRoot":"","sources":["../../../src/editorial/calendar/ContentCalendarView.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAenD,wBAAsB,mBAAmB,CAAC,EACxC,cAAc,EACd,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,GACL,EAAE,oBAAoB,wCAkCtB"}

package/dist/editorial/calendar/ContentCalendarView.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } 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 { readCalendarMonth } from './calendar.js';
+import { ContentCalendarReport } from './ContentCalendarReport.js';
+/*
+`/admin/content-calendar`: a month at a glance. The dashboard lists the next
+few scheduled publishes; this shows the month: what goes live next week, whether
+two campaign pages collide, an event beside the post announcing it.
+
+Read-only. Rescheduling is a pipeline operation, done from the document's own
+Schedule control. The month is in the URL (`?month=2026-10`) so it can be
+linked. `editorialPlugin` registers it with the site's sources and zone.
+*/
+export async function ContentCalendarView({ initPageResult, params, searchParams, payload, i18n, }) {
+    const { req, permissions, locale, visibleEntities } = initPageResult;
+    // The signed-in person arrives on the request, not as the `user` prop.
+    const { user } = req;
+    const { admin } = payload.config.routes;
+    const runtime = editorialRuntime(payload.config).calendar;
+    const here = `${admin}${runtime?.path ?? '/content-calendar'}`;
+    if (!user)
+        redirect(`${admin}/login?redirect=${encodeURIComponent(here)}`);
+    if (!runtime)
+        throw new Error('ContentCalendarView: editorialPlugin was given no `calendar`.');
+    const calendar = await readCalendarMonth(payload, {
+        calendar: runtime.options,
+        user,
+        month: searchParams?.['month'],
+    });
+    const view = searchParams?.['view'] === 'list' ? 'list' : 'grid';
+    return (_jsx(DefaultTemplate, { i18n: i18n, ...(locale ? { locale } : {}), ...(params ? { params } : {}), payload: payload, permissions: permissions, req: req, ...(searchParams ? { searchParams } : {}), user: user, visibleEntities: visibleEntities, children: _jsx(Gutter, { className: "tl-calendar", children: _jsx(ContentCalendarReport, { calendar: calendar, view: view, here: here, adminRoute: admin }) }) }));
+}
+//# sourceMappingURL=ContentCalendarView.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContentCalendarView.js","sourceRoot":"","sources":["../../../src/editorial/calendar/ContentCalendarView.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,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE;;;;;;;;EAQE;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,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,uEAAuE;IACvE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAA;IACpB,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;IACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAA;IACzD,MAAM,IAAI,GAAG,GAAG,KAAK,GAAG,OAAO,EAAE,IAAI,IAAI,mBAAmB,EAAE,CAAA;IAC9D,IAAI,CAAC,IAAI;QAAE,QAAQ,CAAC,GAAG,KAAK,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1E,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;IAE9F,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE;QAChD,QAAQ,EAAE,OAAO,CAAC,OAAO;QACzB,IAAI;QACJ,KAAK,EAAE,YAAY,EAAE,CAAC,OAAO,CAAC;KAC/B,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IAEhE,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,KAAC,MAAM,IAAC,SAAS,EAAC,aAAa,YAC7B,KAAC,qBAAqB,IAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,GAAI,GACjF,GACO,CACnB,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { Payload, PayloadRequest } from 'payload';
+import { type CalendarItem, type CalendarSources } from './find.js';
+import { type CalendarClock, type Month } from './month.js';
+export interface CalendarOptions extends CalendarSources {
+    /** The site's IANA zone. Every item is placed on its day there. */
+    timeZone: string;
+    /** "ET" for `America/New_York`. Default: Intl's short generic name. */
+    zoneLabel?: (zone: string) => string;
+}
+export interface CalendarMonth {
+    month: Month;
+    /** Every day on the grid, whole weeks, Sunday first. */
+    days: string[];
+    /** Items by day key, sorted by time. */
+    items: Map<string, CalendarItem[]>;
+    /** Today's key, in the site's zone. */
+    today: string;
+    clock: CalendarClock;
+}
+export declare function clockFor(options: CalendarOptions): CalendarClock;
+export declare function readCalendarMonth(payload: Payload, options: {
+    calendar: CalendarOptions;
+    user: PayloadRequest['user'];
+    /** `2026-10`; anything else means the current month. */
+    month?: unknown;
+    now?: Date;
+}): Promise<CalendarMonth>;
+/** The days of the month itself, without the grid's lead-in and run-out. */
+export declare function daysInMonth(calendar: CalendarMonth): string[];
+//# sourceMappingURL=calendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../src/editorial/calendar/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,EAAuB,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AACxF,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,YAAY,CAAA;AAQnB,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAA;IACZ,wDAAwD;IACxD,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,wCAAwC;IACxC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAA;IAClC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,aAAa,CAAA;CACrB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAEhE;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IACP,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC5B,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,IAAI,CAAA;CACX,GACA,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAE7D"}

package/dist/editorial/calendar/calendar.js

@@ -0,0 +1,23 @@
+import { findContentCalendar } from './find.js';
+import { calendarClock, gridDays, monthParam, queryRange, } from './month.js';
+export function clockFor(options) {
+    return calendarClock(options.timeZone, options.zoneLabel);
+}
+export async function readCalendarMonth(payload, options) {
+    const clock = clockFor(options.calendar);
+    const now = options.now ?? new Date();
+    const month = clock.parseMonth(options.month, now);
+    const days = gridDays(month);
+    const items = await findContentCalendar(payload, {
+        sources: options.calendar,
+        clock,
+        user: options.user,
+        range: queryRange(days),
+    });
+    return { month, days, items, today: clock.dayKey(now), clock };
+}
+/** The days of the month itself, without the grid's lead-in and run-out. */
+export function daysInMonth(calendar) {
+    return calendar.days.filter((key) => key.startsWith(monthParam(calendar.month)));
+}
+//# sourceMappingURL=calendar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../../src/editorial/calendar/calendar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAA2C,MAAM,WAAW,CAAA;AACxF,OAAO,EACL,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,GAGX,MAAM,YAAY,CAAA;AA0BnB,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,OAAO,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAgB,EAChB,OAMC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC5B,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE;QAC/C,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;KACxB,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAA;AAChE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,QAAuB;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClF,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { CollectionSlug, Payload, PayloadRequest } from 'payload';
+import type { CalendarClock } from './month.js';
+export type CalendarKind = 'scheduled' | 'published' | 'event';
+export interface CalendarItem {
+    kind: CalendarKind;
+    collection: string;
+    id: number | string;
+    title: string;
+    at: string;
+    /** The event's own zone, for `timeLabel`. */
+    zone?: string;
+    /** An event that has never been published. */
+    draft?: boolean;
+}
+export interface CalendarEventSource {
+    collection: CollectionSlug;
+    /** Default `startsAt`. */
+    startsField?: string;
+    /** The field holding the zone the start was entered in, if any. Payload's own is `<startsField>_tz`. */
+    zoneField?: string;
+}
+export interface CalendarSources {
+    /** The collections whose scheduled publishes and publishes are shown. */
+    collections: readonly CollectionSlug[];
+    /** Default `scheduledPublishAt`, the field `publishingPlugin` schedules by. */
+    scheduledField?: string;
+    /** Default `publishedAt`. */
+    publishedField?: string;
+    events?: readonly CalendarEventSource[];
+}
+/** Every item between `from` and `to`, bucketed by site day and sorted by time. */
+export declare function findContentCalendar(payload: Payload, options: {
+    sources: CalendarSources;
+    clock: CalendarClock;
+    user: PayloadRequest['user'];
+    range: {
+        from: string;
+        to: string;
+    };
+}): Promise<Map<string, CalendarItem[]>>;
+//# sourceMappingURL=find.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/editorial/calendar/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAS,MAAM,SAAS,CAAA;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAyB/C,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAA;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,cAAc,CAAA;IAC1B,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,WAAW,EAAE,SAAS,cAAc,EAAE,CAAA;IACtC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACxC;AAcD,mFAAmF;AACnF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IACP,OAAO,EAAE,eAAe,CAAA;IACxB,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC5B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CACpC,GACA,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CA2GtC"}

package/dist/editorial/calendar/find.js

@@ -0,0 +1,108 @@
+const between = (field, from, to) => ({
+    and: [{ [field]: { greater_than_equal: from } }, { [field]: { less_than: to } }],
+});
+function titleOf(doc) {
+    for (const key of ['title', 'name']) {
+        const value = doc[key];
+        if (typeof value === 'string' && value !== '')
+            return value;
+    }
+    return 'Untitled';
+}
+/** Every item between `from` and `to`, bucketed by site day and sorted by time. */
+export async function findContentCalendar(payload, options) {
+    const { from, to } = options.range;
+    const scheduledField = options.sources.scheduledField ?? 'scheduledPublishAt';
+    const publishedField = options.sources.publishedField ?? 'publishedAt';
+    const common = {
+        depth: 0,
+        limit: 0,
+        pagination: false,
+        overrideAccess: false,
+        user: options.user,
+    };
+    const rows = (docs) => docs;
+    const reads = [];
+    for (const collection of options.sources.collections) {
+        reads.push(payload
+            .find({
+            ...common,
+            collection,
+            draft: true,
+            where: between(scheduledField, from, to),
+            select: { title: true, name: true, [scheduledField]: true },
+        })
+            .then(({ docs }) => rows(docs).map((doc) => ({
+            kind: 'scheduled',
+            collection,
+            id: doc['id'],
+            title: titleOf(doc),
+            at: doc[scheduledField],
+        }))), payload
+            .find({
+            ...common,
+            collection,
+            where: { and: [{ _status: { equals: 'published' } }, between(publishedField, from, to)] },
+            select: { title: true, name: true, [publishedField]: true },
+        })
+            .then(({ docs }) => rows(docs).map((doc) => ({
+            kind: 'published',
+            collection,
+            id: doc['id'],
+            title: titleOf(doc),
+            at: doc[publishedField],
+        }))));
+    }
+    for (const source of options.sources.events ?? []) {
+        const starts = source.startsField ?? 'startsAt';
+        reads.push(payload
+            .find({
+            ...common,
+            collection: source.collection,
+            draft: true,
+            where: between(starts, from, to),
+            select: {
+                title: true,
+                name: true,
+                [starts]: true,
+                ...(source.zoneField ? { [source.zoneField]: true } : {}),
+                _status: true,
+                [publishedField]: true,
+            },
+        })
+            .then(({ docs }) => rows(docs).map((doc) => {
+            const zone = source.zoneField ? doc[source.zoneField] : undefined;
+            return {
+                kind: 'event',
+                collection: source.collection,
+                id: doc['id'],
+                title: titleOf(doc),
+                at: doc[starts],
+                ...(typeof zone === 'string' ? { zone } : {}),
+                // The latest version of a published event with pending edits is
+                // a draft; the publish stamp is what says it has been live.
+                ...(doc['_status'] !== 'published' && !doc[publishedField] ? { draft: true } : {}),
+            };
+        })));
+    }
+    const settled = await Promise.allSettled(reads);
+    const days = new Map();
+    for (const result of settled) {
+        if (result.status === 'rejected') {
+            payload.logger.warn({ err: result.reason }, 'Content calendar: a collection did not answer.');
+            continue;
+        }
+        for (const item of result.value) {
+            if (typeof item.at !== 'string')
+                continue;
+            const key = options.clock.dayKey(item.at);
+            const list = days.get(key) ?? [];
+            list.push(item);
+            days.set(key, list);
+        }
+    }
+    for (const list of days.values())
+        list.sort((a, b) => a.at.localeCompare(b.at));
+    return days;
+}
+//# sourceMappingURL=find.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/editorial/calendar/find.ts"],"names":[],"mappings":"AA0DA,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,EAAU,EAAS,EAAE,CAAC,CAAC;IACnE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC;CACjF,CAAC,CAAA;AAEF,SAAS,OAAO,CAAC,GAA4B;IAC3C,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;IAC7D,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAgB,EAChB,OAKC;IAED,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;IAClC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,IAAI,oBAAoB,CAAA;IAC7E,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,IAAI,aAAa,CAAA;IACtE,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,KAAK;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI;KACV,CAAA;IAEV,MAAM,IAAI,GAAG,CAAC,IAAe,EAAE,EAAE,CAAC,IAAiC,CAAA;IACnE,MAAM,KAAK,GAA8B,EAAE,CAAA;IAE3C,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CACR,OAAO;aACJ,IAAI,CAAC;YACJ,GAAG,MAAM;YACT,UAAU;YACV,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,EAAW;SACrE,CAAC;aACD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACjB,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,WAAoB;YAC1B,UAAU;YACV,EAAE,EAAE,GAAG,CAAC,IAAI,CAAoB;YAChC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;YACnB,EAAE,EAAE,GAAG,CAAC,cAAc,CAAW;SAClC,CAAC,CAAC,CACJ,EACH,OAAO;aACJ,IAAI,CAAC;YACJ,GAAG,MAAM;YACT,UAAU;YACV,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE;YACzF,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,EAAW;SACrE,CAAC;aACD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACjB,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,WAAoB;YAC1B,UAAU;YACV,EAAE,EAAE,GAAG,CAAC,IAAI,CAAoB;YAChC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;YACnB,EAAE,EAAE,GAAG,CAAC,cAAc,CAAW;SAClC,CAAC,CAAC,CACJ,CACJ,CAAA;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,IAAI,UAAU,CAAA;QAC/C,KAAK,CAAC,IAAI,CACR,OAAO;aACJ,IAAI,CAAC;YACJ,GAAG,MAAM;YACT,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,EAAE;gBACN,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,IAAI;gBACV,CAAC,MAAM,CAAC,EAAE,IAAI;gBACd,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,OAAO,EAAE,IAAI;gBACb,CAAC,cAAc,CAAC,EAAE,IAAI;aACd;SACX,CAAC;aACD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACjB,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACjE,OAAO;gBACL,IAAI,EAAE,OAAgB;gBACtB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,EAAE,EAAE,GAAG,CAAC,IAAI,CAAoB;gBAChC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;gBACnB,EAAE,EAAE,GAAG,CAAC,MAAM,CAAW;gBACzB,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,gEAAgE;gBAChE,4DAA4D;gBAC5D,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnF,CAAA;QACH,CAAC,CAAC,CACH,CACJ,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAA;IAC9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,gDAAgD,CAAC,CAAA;YAC7F,SAAQ;QACV,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;gBAAE,SAAQ;YACzC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;YAChC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACf,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/E,OAAO,IAAI,CAAA;AACb,CAAC"}

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

@@ -0,0 +1,45 @@
+export interface Month {
+    year: number;
+    /** 1–12. */
+    month: number;
+}
+/** `2026-10`, as the query string carries it. */
+export declare function monthParam({ year, month }: Month): string;
+/** The month `delta` months from `from`. */
+export declare function shiftMonth(from: Month, delta: number): Month;
+/** Every day key in the grid: whole weeks, Sunday first, covering the month. */
+export declare function gridDays({ year, month }: Month): string[];
+/**
+ * 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 declare function queryRange(days: readonly string[]): {
+    from: string;
+    to: string;
+};
+/** "October 2026". */
+export declare function monthTitle({ year, month }: Month): string;
+/** "Thursday, October 1", for the agenda list. */
+export declare function dayTitle(key: string): string;
+/** What follows a time: "ET". Intl's short generic name, e.g. "ET", "PT". */
+export declare function defaultZoneLabel(zone: string): string;
+export interface CalendarClock {
+    zone: string;
+    /** The zone's label: "ET". */
+    label: string;
+    /** The calendar day an instant falls on, in the site's zone. */
+    dayKey: (instant: string | Date) => string;
+    /** `?month=2026-10`, or the current month in the site's zone when absent or malformed. */
+    parseMonth: (param: unknown, now: Date) => Month;
+    /**
+     * The time of an item in the site's zone, and in its own zone too when that
+     * differs: "2:00 PM ET (11:00 AM PT)". An event entered in Pacific time is
+     * still placed on the site's day, and the second clause keeps what its author
+     * typed.
+     */
+    timeLabel: (instant: string, ownZone?: unknown) => string;
+}
+/** The zone-bound half of the arithmetic. */
+export declare function calendarClock(zone: string, zoneLabel?: (zone: string) => string): CalendarClock;
+//# sourceMappingURL=month.d.ts.map