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

package/dist/editorial/health/checks.js

@@ -0,0 +1,188 @@
+/** `now` minus `months` calendar months, as an ISO string. */
+export function monthsBefore(now, months) {
+    const cutoff = new Date(now);
+    cutoff.setUTCMonth(cutoff.getUTCMonth() - months);
+    return cutoff.toISOString();
+}
+/** The first field of `doc` that holds a parseable date. */
+function firstDate(doc, fields) {
+    for (const field of fields) {
+        const value = doc[field];
+        if (typeof value === 'string' && value.trim() !== '' && !Number.isNaN(Date.parse(value))) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** A dotted path out of a document: `meta.description`. */
+function at(doc, path) {
+    let value = doc;
+    for (const key of path.split('.')) {
+        if (value === null || typeof value !== 'object')
+            return undefined;
+        value = value[key];
+    }
+    return value;
+}
+/** `meta.description` to `{ meta: { description: true } }`, for a `select`. */
+function selectOf(paths) {
+    const select = {};
+    for (const path of paths) {
+        const [head, ...rest] = path.split('.');
+        if (rest.length === 0)
+            select[head] = true;
+        else
+            select[head] = {
+                ...(select[head] ?? {}),
+                ...selectOf([rest.join('.')]),
+            };
+    }
+    return select;
+}
+/*
+"Published", in a form the count and the list it links to agree on. The count
+reads the main row, where `_status` is the live state; the admin list of a
+versioned collection reads each document's latest version, where a published
+page with unpublished edits says `draft`. A stamped first-publish date carries
+into every later draft, so it closes that gap.
+*/
+function publishedWhere(publishedField) {
+    if (publishedField === false)
+        return { _status: { equals: 'published' } };
+    return { or: [{ _status: { equals: 'published' } }, { [publishedField]: { exists: true } }] };
+}
+/**
+ * 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 function staleCheck(options) {
+    const dates = options.dates ?? ['revisedAt', 'publishedAt', 'createdAt'];
+    const published = publishedWhere(options.publishedField ?? 'publishedAt');
+    return {
+        id: 'stale',
+        label: options.label ?? 'Not revised recently',
+        ...(options.description ? { description: options.description } : {}),
+        empty: options.empty ?? 'Everything has been revised recently.',
+        collections: Object.keys(options.after),
+        where: (collection, now) => {
+            const months = options.after[collection];
+            if (months === undefined)
+                return null;
+            const cutoff = monthsBefore(now, months);
+            // Dated by the first field that is set: each branch says "this one is
+            // old and every field before it is empty".
+            const branches = dates.map((field, index) => index === 0
+                ? { [field]: { less_than: cutoff } }
+                : {
+                    and: [
+                        ...dates.slice(0, index).map((earlier) => ({ [earlier]: { exists: false } })),
+                        { [field]: { less_than: cutoff } },
+                    ],
+                });
+            return { and: [published, { or: branches }] };
+        },
+        select: selectOf(['title', ...dates]),
+        order: (a, b) => (a.at ?? '').localeCompare(b.at ?? ''),
+        describe: (doc) => {
+            const date = firstDate(doc, dates);
+            return date ? { at: date } : { note: 'never dated' };
+        },
+    };
+}
+/** Published, indexable documents with no meta description or no meta image. */
+export function missingSeoCheck(options) {
+    const description = options.fields?.description ?? 'meta.description';
+    const image = options.fields?.image ?? 'meta.image';
+    const noIndex = options.fields?.noIndex === undefined ? 'meta.noIndex' : options.fields.noIndex;
+    const published = publishedWhere(options.publishedField ?? 'publishedAt');
+    const where = {
+        and: [
+            published,
+            ...(noIndex ? [{ [noIndex]: { not_equals: true } }] : []),
+            {
+                or: [
+                    { [description]: { exists: false } },
+                    { [description]: { equals: '' } },
+                    { [image]: { exists: false } },
+                ],
+            },
+        ],
+    };
+    return {
+        id: 'missing-seo',
+        label: options.label ?? 'Missing SEO',
+        ...(options.description ? { description: options.description } : {}),
+        empty: options.empty ?? 'Every published page has a meta description and image.',
+        collections: options.collections,
+        where: () => where,
+        select: selectOf(['title', description, image]),
+        sort: options.sort ?? '-publishedAt',
+        describe: (doc) => {
+            const missing = [];
+            if (!at(doc, description))
+                missing.push('description');
+            const img = at(doc, image);
+            if (img === null || img === undefined)
+                missing.push('image');
+            return missing.length > 0 ? { note: `no ${missing.join(' or ')}` } : {};
+        },
+    };
+}
+/** Image uploads with no alt text, by default only those something uses. */
+export function missingAltCheck(options = {}) {
+    const collection = options.collection ?? 'media';
+    const alt = options.altField ?? 'alt';
+    const onlyInUse = options.onlyInUse ?? true;
+    if (onlyInUse && !options.inUse) {
+        throw new Error('missingAltCheck: onlyInUse needs `inUse`, e.g. findReferencedIds from @forumone/throughline/media.');
+    }
+    const where = {
+        and: [
+            { mimeType: { like: 'image/' } },
+            { or: [{ [alt]: { exists: false } }, { [alt]: { equals: '' } }] },
+        ],
+    };
+    return {
+        id: 'missing-alt',
+        label: options.label ?? (onlyInUse ? 'Images in use without alt text' : 'Images without alt text'),
+        ...(options.description ? { description: options.description } : {}),
+        empty: options.empty ??
+            (onlyInUse ? 'Every image in use has alt text.' : 'Every image has alt text.'),
+        collections: [collection],
+        where: () => where,
+        select: { filename: true, updatedAt: true },
+        sort: '-updatedAt',
+        ...(onlyInUse && options.inUse
+            ? {
+                costly: true,
+                refine: async (docs, payload) => {
+                    const used = await options.inUse(payload, collection);
+                    return docs.filter((doc) => used.has(String(doc['id'])));
+                },
+            }
+            : {}),
+    };
+}
+/**
+ * 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 function whereQuery(where) {
+    const pairs = [];
+    const walk = (value, key) => {
+        if (Array.isArray(value))
+            value.forEach((item, index) => walk(item, `${key}[${index}]`));
+        else if (value !== null && typeof value === 'object')
+            for (const [k, v] of Object.entries(value))
+                walk(v, `${key}[${k}]`);
+        else
+            pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    };
+    walk(where, 'where');
+    return pairs.join('&');
+}
+/** The admin list for `collection`, filtered by `where`. */
+export function listHref(adminRoute, collection, where) {
+    return `${adminRoute}/collections/${collection}?${whereQuery(where)}`;
+}
+//# sourceMappingURL=checks.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { Payload, PayloadRequest, Where } from 'payload';
+import type { HealthCheck, HealthRow } from './checks.js';
+/** One collection's share of a check. */
+export interface HealthGroup {
+    collection: string;
+    label: string;
+    singular: string;
+    /** The query the count ran, for a link to the list it counted. */
+    where: Where;
+    total: number;
+    /** The first rows, up to the limit. Empty in a summary. */
+    rows: HealthRow[];
+    /** Matched the `where` but were dropped by `refine`: images with no alt that nothing uses. */
+    excluded?: number;
+}
+export interface HealthCheckResult {
+    id: string;
+    label: string;
+    description?: string;
+    empty: string;
+    groups: HealthGroup[];
+    /** Set when the check did not run: `costly` in a summary, `failed` when its read threw. */
+    skipped?: 'costly' | 'failed';
+}
+export interface HealthReport {
+    generatedAt: string;
+    checks: HealthCheckResult[];
+}
+export interface FindContentNeedingAttentionOptions {
+    checks: readonly HealthCheck[];
+    /** Who is asking. Their access decides what is counted. */
+    user: PayloadRequest['user'];
+    now?: Date;
+    /** `summary`: counts only, costly checks skipped, for the dashboard. Default `full`. */
+    scope?: 'summary' | 'full';
+    /** Rows per collection. Default 10. */
+    limit?: number;
+    /** Only these check ids. */
+    only?: readonly string[];
+}
+/** What needs attention, by check and collection. */
+export declare function findContentNeedingAttention(payload: Payload, options: FindContentNeedingAttentionOptions): Promise<HealthReport>;
+//# sourceMappingURL=find.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/editorial/health/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAgBzD,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,wFAAwF;IACxF,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAC1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB;AAyED,qDAAqD;AACrD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,YAAY,CAAC,CA2CvB"}

package/dist/editorial/health/find.js

@@ -0,0 +1,97 @@
+function labelsOf(payload, slug) {
+    const { plural, singular } = payload.collections[slug]?.config.labels ?? {};
+    return {
+        label: typeof plural === 'string' ? plural : slug,
+        singular: typeof singular === 'string' ? singular : slug,
+    };
+}
+function titleOf(doc) {
+    for (const key of ['title', 'name', 'filename', 'slug']) {
+        const value = doc[key];
+        if (typeof value === 'string' && value.trim() !== '')
+            return value;
+    }
+    return 'Untitled';
+}
+function rowOf(check, doc, now) {
+    return {
+        id: doc['id'],
+        title: titleOf(doc),
+        ...(check.describe ? check.describe(doc, now) : {}),
+    };
+}
+async function runGroup(payload, check, collection, options) {
+    const where = check.where(collection, options.now);
+    if (!where)
+        return null;
+    const base = { ...labelsOf(payload, collection), collection, where };
+    const access = { overrideAccess: false, user: options.user };
+    if (options.scope === 'summary') {
+        const { totalDocs } = await payload.count({ collection, where, ...access });
+        return { ...base, total: totalDocs, rows: [] };
+    }
+    // Every match when the order or the refine step needs the whole set; otherwise a page.
+    const all = Boolean(check.order || check.refine);
+    const result = await payload.find({
+        collection,
+        where,
+        depth: 0,
+        ...(all ? { limit: 0, pagination: false } : { limit: options.limit }),
+        ...(check.sort && !check.order ? { sort: check.sort } : {}),
+        select: { ...check.select },
+        ...access,
+    });
+    let docs = result.docs;
+    let excluded;
+    if (check.refine) {
+        const kept = await check.refine(docs, payload);
+        excluded = docs.length - kept.length;
+        docs = kept;
+    }
+    let rows = docs.map((doc) => rowOf(check, doc, options.now));
+    if (check.order)
+        rows = rows.sort(check.order);
+    return {
+        ...base,
+        total: check.refine ? docs.length : result.totalDocs,
+        rows: rows.slice(0, options.limit),
+        ...(excluded !== undefined ? { excluded } : {}),
+    };
+}
+/** What needs attention, by check and collection. */
+export async function findContentNeedingAttention(payload, options) {
+    const now = options.now ?? new Date();
+    const scope = options.scope ?? 'full';
+    const limit = options.limit ?? 10;
+    const checks = options.only
+        ? options.checks.filter((check) => options.only.includes(check.id))
+        : options.checks;
+    const results = await Promise.all(checks.map(async (check) => {
+        const head = {
+            id: check.id,
+            label: check.label,
+            ...(check.description ? { description: check.description } : {}),
+            empty: check.empty,
+        };
+        if (scope === 'summary' && check.costly)
+            return { ...head, groups: [], skipped: 'costly' };
+        const settled = await Promise.allSettled(check.collections.map((collection) => runGroup(payload, check, collection, { scope, limit, user: options.user, now })));
+        const groups = [];
+        let failed = 0;
+        for (const outcome of settled) {
+            if (outcome.status === 'rejected') {
+                failed += 1;
+                payload.logger.warn({ err: outcome.reason, check: check.id }, 'Content health: a collection did not answer.');
+            }
+            else if (outcome.value) {
+                groups.push(outcome.value);
+            }
+        }
+        // Every collection failed: that is "could not check", not "nothing found".
+        if (failed > 0 && groups.length === 0)
+            return { ...head, groups: [], skipped: 'failed' };
+        return { ...head, groups };
+    }));
+    return { generatedAt: now.toISOString(), checks: results };
+}
+//# sourceMappingURL=find.js.map

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

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

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

@@ -0,0 +1,53 @@
+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 { HealthCheck } from './checks.js';
+import { type HealthReport } from './find.js';
+export declare const HEALTH_TOOLS: {
+    readonly findContentNeedingAttention: {
+        readonly name: "find_content_needing_attention";
+        readonly description: "Lists published content that needs a review, by check: pages not revised within their threshold, pages missing a meta description or image, images in use without alt text, and any other checks the site configures. Each result names the document, why it is listed, and its admin link. Use for \"what is going stale?\", \"what needs SEO work?\", or a content review. Pass `checks` to run only some of them.";
+    };
+};
+export declare const HEALTH_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+declare const inputSchema: z.ZodObject<{
+    checks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    checks?: string[] | undefined;
+}, {
+    limit?: number | undefined;
+    checks?: string[] | undefined;
+}>;
+export interface HealthToolDeps {
+    payload: Payload;
+    checks: readonly HealthCheck[];
+}
+/** The report as the tool returns it: no `where`, and an admin link per row. */
+export declare function toolReport(report: HealthReport, adminRoute: string): {
+    generatedAt: string;
+    checks: {
+        total: number;
+        groups: {
+            documents: {
+                adminUrl: string;
+                id: number | string;
+                title: string;
+                at?: string;
+                note?: string;
+            }[];
+            excluded?: number;
+            collection: string;
+            label: string;
+            total: number;
+        }[];
+        skipped?: "costly" | "failed";
+        id: string;
+        label: string;
+    }[];
+};
+export declare function createFindContentNeedingAttentionTool(deps: HealthToolDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/editorial/health/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,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAU1E,eAAO,MAAM,YAAY;;;;;CAM6B,CAAA;AAEtD,eAAO,MAAM,uBAAuB,EAAE,SAAS,iBAAiB,EAAgC,CAAA;AAEhG,QAAA,MAAM,WAAW;;;;;;;;;EAYf,CAAA;AAEF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;CAC/B;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;EAsBlE;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,cAAc,GACnB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CA0BvC"}

package/dist/editorial/health/tool.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { findContentNeedingAttention } from './find.js';
+/*
+The content-health view, as an MCP tool. It calls the same function the view
+does, with the same checks, as the caller, so an agent and the admin see the
+same rows. The only difference is that the tool leaves out each group's
+`where` (the view needs it to link to the filtered list; an agent does not) and
+links each row to its admin page instead.
+*/
+export const HEALTH_TOOLS = {
+    findContentNeedingAttention: {
+        name: 'find_content_needing_attention',
+        description: 'Lists published content that needs a review, by check: pages not revised within their threshold, pages missing a meta description or image, images in use without alt text, and any other checks the site configures. Each result names the document, why it is listed, and its admin link. Use for "what is going stale?", "what needs SEO work?", or a content review. Pass `checks` to run only some of them.',
+    },
+};
+export const HEALTH_TOOL_DESCRIPTORS = Object.values(HEALTH_TOOLS);
+const inputSchema = z.object({
+    checks: z
+        .array(z.string())
+        .optional()
+        .describe('Check ids to run, e.g. ["stale"]. Default: all.'),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe('Documents per collection. Default: 10.'),
+});
+/** The report as the tool returns it: no `where`, and an admin link per row. */
+export function toolReport(report, adminRoute) {
+    return {
+        generatedAt: report.generatedAt,
+        checks: report.checks.map((check) => ({
+            id: check.id,
+            label: check.label,
+            ...(check.skipped ? { skipped: check.skipped } : {}),
+            total: check.groups.reduce((sum, group) => sum + group.total, 0),
+            groups: check.groups
+                .filter((group) => group.total > 0)
+                .map((group) => ({
+                collection: group.collection,
+                label: group.label,
+                total: group.total,
+                ...(group.excluded ? { excluded: group.excluded } : {}),
+                documents: group.rows.map((row) => ({
+                    ...row,
+                    adminUrl: `${adminRoute}/collections/${group.collection}/${String(row.id)}`,
+                })),
+            })),
+        })),
+    };
+}
+export function createFindContentNeedingAttentionTool(deps) {
+    return {
+        ...HEALTH_TOOLS.findContentNeedingAttention,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!ctx.user) {
+                return {
+                    error: 'Must be authenticated: content health is read with your own access, and an API key alone carries no identity.',
+                };
+            }
+            const known = new Set(deps.checks.map((check) => check.id));
+            const unknown = (input.checks ?? []).filter((id) => !known.has(id));
+            if (unknown.length > 0) {
+                return { error: `Unknown check ${unknown.join(', ')}. Known: ${[...known].join(', ')}.` };
+            }
+            const report = await findContentNeedingAttention(deps.payload, {
+                checks: deps.checks,
+                // The same cast and the same reason as publishing's `resolvePublishingActor`.
+                user: ctx.user,
+                ...(input.checks ? { only: input.checks } : {}),
+                ...(input.limit ? { limit: input.limit } : {}),
+            });
+            return toolReport(report, deps.payload.config.routes.admin);
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

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

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

package/dist/editorial/index.d.ts

@@ -0,0 +1,25 @@
+export { editorialPlugin, CONTENT_CALENDAR_VIEW_PATH, CONTENT_HEALTH_VIEW_PATH, YOUR_WORK_DASHBOARD_PATH, COMMAND_PALETTE_PATH, REPORTS_NAV_PATH, } from './plugin.js';
+export type { EditorialPluginOptions } from './plugin.js';
+export { listHref, missingAltCheck, missingSeoCheck, monthsBefore, staleCheck, whereQuery, } from './health/checks.js';
+export type { HealthCheck, HealthRow, MissingAltCheckOptions, MissingSeoCheckOptions, StaleCheckOptions, } from './health/checks.js';
+export { findContentNeedingAttention } from './health/find.js';
+export type { FindContentNeedingAttentionOptions, HealthCheckResult, HealthGroup, HealthReport, } from './health/find.js';
+export { HEALTH_TOOLS, HEALTH_TOOL_DESCRIPTORS, createFindContentNeedingAttentionTool, toolReport, } from './health/tool.js';
+export type { HealthToolDeps } from './health/tool.js';
+export { relativeTime } from './relativeTime.js';
+export { clockFor, daysInMonth, readCalendarMonth } from './calendar/calendar.js';
+export type { CalendarMonth, CalendarOptions } from './calendar/calendar.js';
+export { findContentCalendar } from './calendar/find.js';
+export type { CalendarEventSource, CalendarItem, CalendarKind, CalendarSources, } from './calendar/find.js';
+export { calendarClock, dayTitle, defaultZoneLabel, gridDays, monthParam, monthTitle, queryRange, shiftMonth, } from './calendar/month.js';
+export type { CalendarClock, Month } from './calendar/month.js';
+export { CALENDAR_TOOLS, CALENDAR_TOOL_DESCRIPTORS, createGetContentCalendarTool, toolCalendar, } from './calendar/tool.js';
+export { readYourWork } from './work/work.js';
+export type { WorkOptions, WorkRow, YourWorkResult } from './work/work.js';
+export { WORK_TOOLS, WORK_TOOL_DESCRIPTORS, createListMyWorkTool, toolWork } from './work/tool.js';
+export { PER_SOURCE, RECENT_LIMIT, byIdsUrl, documentFromPath, matchCommands, matchRank, pushRecent, readRecent, searchUrl, searchWhere, } from './palette/sources.js';
+export type { Command, RecentEntry, Report, SearchSource } from './palette/sources.js';
+export { searchContent } from './palette/search.js';
+export type { SearchHit } from './palette/search.js';
+export { PALETTE_TOOLS, PALETTE_TOOL_DESCRIPTORS, createSearchContentTool } from './palette/tool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editorial/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD,OAAO,EACL,QAAQ,EACR,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAC9D,YAAY,EACV,kCAAkC,EAClC,iBAAiB,EACjB,WAAW,EACX,YAAY,GACb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,qCAAqC,EACrC,UAAU,GACX,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACjF,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAElG,OAAO,EACL,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/editorial/index.js

@@ -0,0 +1,15 @@
+export { editorialPlugin, CONTENT_CALENDAR_VIEW_PATH, CONTENT_HEALTH_VIEW_PATH, YOUR_WORK_DASHBOARD_PATH, COMMAND_PALETTE_PATH, REPORTS_NAV_PATH, } from './plugin.js';
+export { listHref, missingAltCheck, missingSeoCheck, monthsBefore, staleCheck, whereQuery, } from './health/checks.js';
+export { findContentNeedingAttention } from './health/find.js';
+export { HEALTH_TOOLS, HEALTH_TOOL_DESCRIPTORS, createFindContentNeedingAttentionTool, toolReport, } from './health/tool.js';
+export { relativeTime } from './relativeTime.js';
+export { clockFor, daysInMonth, readCalendarMonth } from './calendar/calendar.js';
+export { findContentCalendar } from './calendar/find.js';
+export { calendarClock, dayTitle, defaultZoneLabel, gridDays, monthParam, monthTitle, queryRange, shiftMonth, } from './calendar/month.js';
+export { CALENDAR_TOOLS, CALENDAR_TOOL_DESCRIPTORS, createGetContentCalendarTool, toolCalendar, } from './calendar/tool.js';
+export { readYourWork } from './work/work.js';
+export { WORK_TOOLS, WORK_TOOL_DESCRIPTORS, createListMyWorkTool, toolWork } from './work/tool.js';
+export { PER_SOURCE, RECENT_LIMIT, byIdsUrl, documentFromPath, matchCommands, matchRank, pushRecent, readRecent, searchUrl, searchWhere, } from './palette/sources.js';
+export { searchContent } from './palette/search.js';
+export { PALETTE_TOOLS, PALETTE_TOOL_DESCRIPTORS, createSearchContentTool } from './palette/tool.js';
+//# sourceMappingURL=index.js.map

package/dist/editorial/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/editorial/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,oBAAoB,CAAA;AAS3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAQ9D,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,qCAAqC,EACrC,UAAU,GACX,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAOxD,OAAO,EACL,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAElG,OAAO,EACL,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/editorial/palette/CommandPalette.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+import { type Report, type SearchSource } from './sources.js';
+export interface CommandPaletteProps {
+    children?: ReactNode;
+    /** What it searches, in the order results are grouped. */
+    sources: SearchSource[];
+    /** Screens that are not collections, offered as "Go to". */
+    reports?: Report[];
+    /** Collections offered as "New …". Default: every source. */
+    creatable?: string[];
+    /** The per-user preference the recent list is kept in. */
+    preferenceKey?: string;
+}
+export declare function CommandPalette({ children, sources, reports, creatable, preferenceKey, }: CommandPaletteProps): import("react").JSX.Element;
+//# sourceMappingURL=CommandPalette.d.ts.map

package/dist/editorial/palette/CommandPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../../src/editorial/palette/CommandPalette.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA4D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChG,OAAO,EAUL,KAAK,MAAM,EACX,KAAK,YAAY,EAClB,MAAM,cAAc,CAAA;AA8BrB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,0DAA0D;IAC1D,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AA4QD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,OAAO,EACP,OAAY,EACZ,SAAS,EACT,aAAoD,GACrD,EAAE,mBAAmB,+BA4IrB"}