@simmalugnt-se/payload-content-health 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.0
+
+- "Fix N with the assistant" on the work list, when it is filtered to missing alt texts, meta titles
+  or descriptions (missing or the wrong length) or missing translations, in collections where the
+  editor assistant (0.11.0 or later) allows `content.update`. It opens the assistant's panel with up
+  to 20 of the documents shown and one prompt for them all (`BATCH_ASK`), through `?batch=`,
+  `?batchScope=` and `?ask=`.
+
+## 0.4.2
+
+- Work-list links open collapsed Payload `collapsible` fields around the target field, found by the
+  id Payload gives them (the same fix as visual editing's).
+
 ## 0.4.1
 
 - Signing in from the work list leads back to it. The login link's `redirect` lacked the Admin route

package/README.md

@@ -139,11 +139,21 @@ other; they share these names:
 | `?field=<path>`                              | link → this plugin      | Form path to bring into view             |
 | `?ask=<prompt>`                              | link → assistant        | Prompt to put in the message box         |
 | `content-health:select` (`detail: { path }`) | this plugin → assistant | The field brought into view is selected  |
-| `config.admin.custom.editorAssistant`        | assistant → this plugin | `{ collections }` the assistant works in |
+| `config.admin.custom.editorAssistant`        | assistant → this plugin | `{ collections, batchCollections }`      |
+| `?batch=…&batchScope=…&ask=…`                | link → assistant        | Documents to fix at once, and the prompt |
 
 Both parameters are removed from the address once read. `editURL(adminRoute, finding, prompt?)` and
 `listURL(adminRoute, filters)` build these links.
 
+### Many documents at once
+
+Where the assistant allows `content.update` (0.11.0 or later), a list filtered to missing alt texts,
+meta titles or descriptions (missing or the wrong length) or missing translations offers "Fix N with
+the assistant" above the rows. It opens the assistant's panel beside the list with up to 20 of the
+documents shown and one prompt for all of them; the assistant proposes a change per document, and
+the editor saves the ones they want. Saved documents drop out of the list. `batchURL(adminRoute,
+filters, targets, prompt)` and `batchTarget(finding)` build the link.
+
 ## Running the checks yourself
 
 ```ts

package/dist/admin/ContentHealthFieldBridge.js

@@ -120,8 +120,8 @@ function formRoot(anchor) {
     return view?.querySelector(".collection-edit__form") ?? document;
 }
 /**
- * Open the rows and tabs the plan needs, one level at a time, waiting for each to render.
- * Returns the innermost scope (row or tab content), where the target renders.
+ * Open the rows, tabs and collapsibles the plan needs, one level at a time.
+ * Returns the innermost scope, where the target renders.
  */
 async function openSteps(steps, root, current) {
     let scope = root;
@@ -137,6 +137,26 @@ async function openSteps(steps, root, current) {
             scope = row;
             continue;
         }
+        if (step.kind === "collapsible") {
+            const collapsibleScope = scope;
+            const field = await waitForRendered(() => collapsibleScope.querySelector(`[id="${collapsibleDomId(step.path)}"]`), collapsibleScope);
+            const element = field?.querySelector(":scope > .collapsible");
+            const button = element?.querySelector(":scope > .collapsible__toggle-wrap > .collapsible__toggle");
+            if (!element || !button) {
+                return null;
+            }
+            if (element.classList.contains("collapsible--collapsed")) {
+                button.click();
+            }
+            const content = await waitFor(() => element.classList.contains("collapsible--collapsed")
+                ? null
+                : element.querySelector(".collapsible__content"));
+            if (!content) {
+                return null;
+            }
+            scope = content;
+            continue;
+        }
         const tabsScope = scope;
         const tabs = await waitForRendered(() => tabsFieldsIn(tabsScope)[step.ordinal] ?? null, tabsScope);
         const button = tabs?.querySelectorAll(":scope > .tabs-field__tabs-wrap > .tabs-field__tabs > .tabs-field__tab-button")[step.index];
@@ -171,13 +191,17 @@ async function waitForRendered(find, scope, timeoutMs = WAIT_MS) {
     }
     return waitFor(find, timeoutMs);
 }
-/** Tabs fields at this level of the scope, in DOM order; nested tabs and rows are other scopes. */
+/** Tabs fields at this level of the scope, in DOM order; nested containers are other scopes. */
 function tabsFieldsIn(scope) {
     return Array.from(scope.querySelectorAll(".tabs-field")).filter((element) => {
-        const outer = element.parentElement?.closest(".tabs-field, .blocks-field, .array-field");
+        const outer = element.parentElement?.closest(".tabs-field, .collapsible-field, .blocks-field, .array-field");
         return !outer || !scope.contains(outer);
     });
 }
+/** Payload's id for a collapsible field: `field-collapsible-` and its path with `__` for dots. */
+function collapsibleDomId(path) {
+    return `field-collapsible-${path.replace(/\./g, "__")}`;
+}
 function waitFor(find, timeoutMs = WAIT_MS) {
     const deadline = performance.now() + timeoutMs;
     return new Promise((resolve) => {

package/dist/admin/reveal-plan.d.ts

@@ -1,6 +1,5 @@
 /**
- * Work out which tabs must be opened to show a form path. Payload only renders the active tab,
- * so a field in another tab has no DOM element until its tab button is clicked.
+ * Work out which tabs and collapsibles must be opened to show a form path.
  * Pure: takes client field config, returns steps for the Admin bridge to perform.
  */
 export type FieldLike = {
@@ -33,6 +32,15 @@ export type RevealStep =
     ordinal: number;
     index: number;
 }
+/**
+ * Open the collapsible field Payload renders at this path, then enter its content. The path is
+ * Payload's own for an unnamed field (`meta._index-0-1`) and gives its DOM id, so a collapsible
+ * hidden by a condition does not shift which one is opened.
+ */
+ | {
+    kind: "collapsible";
+    path: string;
+}
 /** Enter a block or array row. The row element becomes the scope. */
  | {
     kind: "row";

package/dist/admin/reveal-plan.js

@@ -3,8 +3,7 @@
  * clicked in the preview. The packages do not import each other; keep fixes in step with that copy.
  */
 /**
- * Work out which tabs must be opened to show a form path. Payload only renders the active tab,
- * so a field in another tab has no DOM element until its tab button is clicked.
+ * Work out which tabs and collapsibles must be opened to show a form path.
  * Pure: takes client field config, returns steps for the Admin bridge to perform.
  */
 export function planReveal(rootFields, path, lookup) {
@@ -18,22 +17,22 @@ function walkPath(rootFields, path, lookup) {
     const segments = path.split(".");
     const steps = [];
     let fields = rootFields;
-    let counter = { value: 0 };
+    let counter = { tabs: 0 };
     let walked = [];
     let last = null;
     for (let i = 0; i < segments.length;) {
         const segment = segments[i] ?? "";
-        const found = findIn(fields, segment, counter);
+        const found = findIn(fields, segment, counter, { dataPath: walked.join("."), indexPath: "" });
         if (!found) {
             return null;
         }
-        steps.push(...found.tabs);
+        steps.push(...found.steps);
         counter = found.counter;
         walked = [...walked, segment];
         i += 1;
         if (found.kind === "namedTab") {
             fields = found.fields;
-            counter = { value: 0 };
+            counter = { tabs: 0 };
             continue;
         }
         const field = found.field;
@@ -46,7 +45,7 @@ function walkPath(rootFields, path, lookup) {
             steps.push({ kind: "row", parentPath, index: Number(next) });
             walked = [...walked, next];
             i += 1;
-            counter = { value: 0 };
+            counter = { tabs: 0 };
             if (field.type === "array") {
                 fields = field.fields ?? [];
                 continue;
@@ -59,7 +58,7 @@ function walkPath(rootFields, path, lookup) {
             continue;
         }
         if (field.fields) {
-            // Named group: same DOM scope, keep counting tabs.
+            // Named group: same DOM scope, keep counting revealable fields.
             fields = field.fields;
             continue;
         }
@@ -68,51 +67,72 @@ function walkPath(rootFields, path, lookup) {
     }
     return { steps, field: last };
 }
-function findIn(fields, name, counter) {
-    for (const field of fields) {
+function findIn(fields, name, counter, place) {
+    for (const [position, field] of fields.entries()) {
         if (field.type === "tabs") {
-            const ordinal = counter.value;
-            counter.value += 1;
+            const ordinal = counter.tabs;
+            counter.tabs += 1;
+            const tabsPlace = unnamedChild(place, position);
             for (const [index, tab] of (field.tabs ?? []).entries()) {
                 const step = { kind: "tab", ordinal, index };
                 if (tab.name === name) {
                     return {
                         kind: "namedTab",
                         fields: tab.fields ?? [],
-                        tabs: [step],
-                        counter: { value: 0 },
+                        steps: [step],
+                        counter: { tabs: 0 },
                     };
                 }
                 if (!tab.name) {
-                    const inner = findIn(tab.fields ?? [], name, { value: 0 });
+                    const inner = findIn(tab.fields ?? [], name, { tabs: 0 }, unnamedChild(tabsPlace, index));
                     if (inner) {
-                        return { ...inner, tabs: [step, ...inner.tabs] };
+                        return { ...inner, steps: [step, ...inner.steps] };
                     }
                 }
             }
             continue;
         }
         if (field.name === name) {
-            return { kind: "field", field, tabs: [], counter };
+            return { kind: "field", field, steps: [], counter };
         }
         if (!field.name && field.fields) {
-            // Row, collapsible or unnamed group: transparent for paths.
-            const inner = findIn(field.fields, name, counter);
+            // Row, collapsible or unnamed group: no segment in the form path. A collapsible is its own
+            // DOM scope, found by the path Payload gives it.
+            const own = unnamedChild(place, position);
+            if (field.type === "collapsible") {
+                const inner = findIn(field.fields, name, { tabs: 0 }, own);
+                if (inner) {
+                    const path = [place.dataPath, `_index-${own.indexPath}`].filter(Boolean).join(".");
+                    return { ...inner, steps: [{ kind: "collapsible", path }, ...inner.steps] };
+                }
+                continue;
+            }
+            const inner = findIn(field.fields, name, counter, own);
             if (inner) {
                 return inner;
             }
             continue;
         }
-        counter.value += countTabs(field);
+        counter.tabs += countTabs(field);
     }
     return null;
 }
+/** The place of the unnamed field at `position`, whose own fields render there too. */
+function unnamedChild(place, position) {
+    return {
+        dataPath: place.dataPath,
+        indexPath: place.indexPath ? `${place.indexPath}-${position}` : String(position),
+    };
+}
 /** Tabs fields rendered inside a field that is skipped, so later ordinals stay aligned with the DOM. */
 function countTabs(field) {
     if (field.type === "tabs") {
         return 1;
     }
-    if (field.type === "blocks" || field.type === "array" || !field.fields) {
+    if (field.type === "blocks" ||
+        field.type === "array" ||
+        field.type === "collapsible" ||
+        !field.fields) {
         return 0;
     }
     return field.fields.reduce((sum, child) => sum + countTabs(child), 0);

package/dist/copy.d.ts

@@ -50,6 +50,12 @@ type Ask = (finding: Finding) => string;
  * open in the finding's locale with the field selected, so the prompt does not name either.
  */
 export declare const ASK: Record<UiLanguage, Record<CheckId, Ask>>;
+type BatchAsk = (finding: Finding) => string;
+/**
+ * The prompt behind "Fix N with the assistant", once for every document of a check. The assistant
+ * opens each document with the field selected; the numbers are the check's, not one document's.
+ */
+export declare const BATCH_ASK: Record<UiLanguage, Partial<Record<CheckId, BatchAsk>>>;
 export declare const LIST_COPY: {
     readonly en: {
         readonly title: "Content health";
@@ -65,6 +71,7 @@ export declare const LIST_COPY: {
         readonly issue: "Issue";
         readonly draft: "Draft";
         readonly fix: "Fix with the assistant";
+        readonly fixMany: (count: number, total: number) => string;
         readonly none: "No issues found.";
         readonly noneFiltered: "No issues match these filters.";
     };
@@ -82,6 +89,7 @@ export declare const LIST_COPY: {
         readonly issue: "Problem";
         readonly draft: "Utkast";
         readonly fix: "Åtgärda med assistenten";
+        readonly fixMany: (count: number, total: number) => string;
         readonly none: "Inga problem hittades.";
         readonly noneFiltered: "Inga problem matchar filtren.";
     };

package/dist/copy.js

@@ -183,6 +183,74 @@ export const ASK = {
             : "Översätt de tomma fälten.",
     },
 };
+/** The range a length finding aims for, from either kind of meta finding. */
+const aim = ({ length, range }) => length ?? range;
+/**
+ * The prompt behind "Fix N with the assistant", once for every document of a check. The assistant
+ * opens each document with the field selected; the numbers are the check's, not one document's.
+ */
+export const BATCH_ASK = {
+    en: {
+        "media.alt-missing": () => "Write an alt text for the image.",
+        "seo.title-missing": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Write a meta title for the page, ${range.min}–${range.max} characters.`
+                : "Write a meta title for the page.";
+        },
+        "seo.title-length": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Rewrite the meta title to ${range.min}–${range.max} characters.`
+                : "Rewrite the meta title to a better length.";
+        },
+        "seo.description-missing": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Write a meta description for the page, ${range.min}–${range.max} characters.`
+                : "Write a meta description for the page.";
+        },
+        "seo.description-length": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Rewrite the meta description to ${range.min}–${range.max} characters.`
+                : "Rewrite the meta description to a better length.";
+        },
+        "content.untranslated": ({ untranslated }) => untranslated
+            ? `Translate the empty fields from ${languageName("en", untranslated.source)}.`
+            : "Translate the empty fields.",
+    },
+    sv: {
+        "media.alt-missing": () => "Skriv en alt-text för bilden.",
+        "seo.title-missing": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Skriv en metatitel för sidan, ${range.min}–${range.max} tecken.`
+                : "Skriv en metatitel för sidan.";
+        },
+        "seo.title-length": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Skriv om metatiteln till ${range.min}–${range.max} tecken.`
+                : "Skriv om metatiteln till en bättre längd.";
+        },
+        "seo.description-missing": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Skriv en metabeskrivning för sidan, ${range.min}–${range.max} tecken.`
+                : "Skriv en metabeskrivning för sidan.";
+        },
+        "seo.description-length": (finding) => {
+            const range = aim(finding);
+            return range
+                ? `Skriv om metabeskrivningen till ${range.min}–${range.max} tecken.`
+                : "Skriv om metabeskrivningen till en bättre längd.";
+        },
+        "content.untranslated": ({ untranslated }) => untranslated
+            ? `Översätt de tomma fälten från ${languageName("sv", untranslated.source)}.`
+            : "Översätt de tomma fälten.",
+    },
+};
 export const LIST_COPY = {
     en: {
         title: "Content health",
@@ -198,6 +266,9 @@ export const LIST_COPY = {
         issue: "Issue",
         draft: "Draft",
         fix: "Fix with the assistant",
+        fixMany: (count, total) => count < total
+            ? `Fix ${count} of ${total} with the assistant`
+            : `Fix ${count} with the assistant`,
         none: "No issues found.",
         noneFiltered: "No issues match these filters.",
     },
@@ -215,6 +286,9 @@ export const LIST_COPY = {
         issue: "Problem",
         draft: "Utkast",
         fix: "Åtgärda med assistenten",
+        fixMany: (count, total) => count < total
+            ? `Åtgärda ${count} av ${total} med assistenten`
+            : `Åtgärda ${count} med assistenten`,
         none: "Inga problem hittades.",
         noneFiltered: "Inga problem matchar filtren.",
     },

package/dist/links.d.ts

@@ -21,6 +21,20 @@ export declare const SELECT_EVENT = "content-health:select";
  * `config.admin.custom.editorAssistant.collections`. The work list offers the assistant only there.
  */
 export declare const ASSISTANT_CUSTOM_KEY = "editorAssistant";
+/**
+ * Parameters read by `@simmalugnt-se/payload-editor-assistant` on any Admin address: the documents
+ * to fix at once (`collection:id:locale:path`, comma separated), how far each fix may reach, and the
+ * prompt in `ask`. The assistant's panel opens in batch mode and removes them.
+ */
+export declare const BATCH_PARAM = "batch";
+export declare const BATCH_SCOPE_PARAM = "batchScope";
+/** Documents per batch, as the assistant takes them. */
+export declare const MAX_BATCH_TARGETS = 20;
+/**
+ * Checks the assistant can fix in many documents at once, and what each fix may reach: the
+ * finding's field, or every field a translation still has to fill.
+ */
+export declare const BATCH_CHECKS: Partial<Record<CheckId, "field" | "translation">>;
 /**
  * Where to send a visitor who may not use Admin, or null to show the work list. Payload leaves
  * custom views public, so the view checks this itself, as Payload does for its own: to the login
@@ -37,6 +51,15 @@ export declare function accessRedirect(args: {
     searchParams?: Record<string, string | string[] | undefined>;
 }): string | null;
 export declare function assistantCollections(adminCustom: unknown): string[];
+/** Collections where the assistant allows batch changes: `editorAssistant.batchCollections`. */
+export declare function batchCollections(adminCustom: unknown): string[];
+/** A finding as one document of a batch: `collection:id:locale:path`. */
+export declare function batchTarget(finding: Finding): string;
+/**
+ * The work list with its filters, asking the assistant to fix the first `MAX_BATCH_TARGETS` of
+ * `targets` with `ask`. The check filter says how far each fix may reach.
+ */
+export declare function batchURL(adminRoute: string, filters: ListFilters, targets: string[], ask: string): string;
 /** The document in the finding's locale with its field brought into view, and a prompt when given. */
 export declare function editURL(adminRoute: string, finding: Finding, ask?: string): string;
 export type ListFilters = {

package/dist/links.js

@@ -27,6 +27,27 @@ export const SELECT_EVENT = "content-health:select";
  * `config.admin.custom.editorAssistant.collections`. The work list offers the assistant only there.
  */
 export const ASSISTANT_CUSTOM_KEY = "editorAssistant";
+/**
+ * Parameters read by `@simmalugnt-se/payload-editor-assistant` on any Admin address: the documents
+ * to fix at once (`collection:id:locale:path`, comma separated), how far each fix may reach, and the
+ * prompt in `ask`. The assistant's panel opens in batch mode and removes them.
+ */
+export const BATCH_PARAM = "batch";
+export const BATCH_SCOPE_PARAM = "batchScope";
+/** Documents per batch, as the assistant takes them. */
+export const MAX_BATCH_TARGETS = 20;
+/**
+ * Checks the assistant can fix in many documents at once, and what each fix may reach: the
+ * finding's field, or every field a translation still has to fill.
+ */
+export const BATCH_CHECKS = {
+    "media.alt-missing": "field",
+    "seo.title-missing": "field",
+    "seo.title-length": "field",
+    "seo.description-missing": "field",
+    "seo.description-length": "field",
+    "content.untranslated": "translation",
+};
 /**
  * Where to send a visitor who may not use Admin, or null to show the work list. Payload leaves
  * custom views public, so the view checks this itself, as Payload does for its own: to the login
@@ -61,6 +82,31 @@ export function assistantCollections(adminCustom) {
         ? collections.filter((slug) => typeof slug === "string")
         : [];
 }
+/** Collections where the assistant allows batch changes: `editorAssistant.batchCollections`. */
+export function batchCollections(adminCustom) {
+    const entry = adminCustom?.[ASSISTANT_CUSTOM_KEY];
+    const collections = entry?.batchCollections;
+    return Array.isArray(collections)
+        ? collections.filter((slug) => typeof slug === "string")
+        : [];
+}
+/** A finding as one document of a batch: `collection:id:locale:path`. */
+export function batchTarget(finding) {
+    return [finding.collection, String(finding.id), finding.locale ?? "", finding.path].join(":");
+}
+/**
+ * The work list with its filters, asking the assistant to fix the first `MAX_BATCH_TARGETS` of
+ * `targets` with `ask`. The check filter says how far each fix may reach.
+ */
+export function batchURL(adminRoute, filters, targets, ask) {
+    const params = new URLSearchParams(filterQuery(filters));
+    params.set(BATCH_PARAM, targets.slice(0, MAX_BATCH_TARGETS).join(","));
+    if (filters.check && BATCH_CHECKS[filters.check] === "translation") {
+        params.set(BATCH_SCOPE_PARAM, "translation");
+    }
+    params.set(ASK_PARAM, ask);
+    return `${formatAdminURL({ adminRoute, path: VIEW_PATH })}?${params}`;
+}
 /** The document in the finding's locale with its field brought into view, and a prompt when given. */
 export function editURL(adminRoute, finding, ask) {
     const path = `/collections/${finding.collection}/${encodeURIComponent(String(finding.id))}`;

package/dist/styles/view.css

@@ -49,11 +49,20 @@ html[data-theme="dark"] .content-health-list {
 }
 
 .content-health-list__summary {
+  display: flex;
+  flex-wrap: wrap;
+  gap: calc(var(--base) * 0.5) var(--base);
+  align-items: center;
+  justify-content: space-between;
   min-height: 1.5em;
   margin: var(--base) 0 calc(var(--base) * 0.5);
   color: var(--theme-elevation-600);
 }
 
+.content-health-list__summary p {
+  margin: 0;
+}
+
 /* One grid for all rows, so the columns line up; each row takes its tracks through subgrid. */
 .content-health-list__rows {
   display: grid;

package/dist/view/ContentHealthView.js

@@ -2,8 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { DefaultTemplate } from "@payloadcms/next/templates";
 import { Gutter, SetStepNav } from "@payloadcms/ui";
 import { redirect } from "next/navigation";
-import { ASK, CHECK_LABELS, findingDetail, LIST_COPY, uiLanguage } from "../copy.js";
-import { accessRedirect, assistantCollections, editURL, readFilters } from "../links.js";
+import { ASK, BATCH_ASK, CHECK_LABELS, findingDetail, LIST_COPY, uiLanguage } from "../copy.js";
+import { accessRedirect, assistantCollections, BATCH_CHECKS, batchCollections, batchTarget, editURL, readFilters, } from "../links.js";
 import { scanContentHealth } from "../scan.js";
 import { CHECK_IDS } from "../types.js";
 import { WorkList } from "./WorkList.js";
@@ -31,8 +31,14 @@ export async function ContentHealthView({ initPageResult, params, searchParams,
     const adminRoute = config.routes.admin;
     const result = await scanContentHealth({ payload: req.payload, user: req.user });
     const withAssistant = new Set(assistantCollections(config.admin?.custom));
+    const inBatches = new Set(batchCollections(config.admin?.custom));
+    const batchAsk = {};
     const rows = sortFindings(result.findings).map((finding, index) => {
         const detail = findingDetail(language, finding);
+        const batchable = Boolean(BATCH_CHECKS[finding.check]) && inBatches.has(finding.collection);
+        if (batchable && !batchAsk[finding.check]) {
+            batchAsk[finding.check] = BATCH_ASK[language][finding.check]?.(finding);
+        }
         return {
             key: `${index}:${finding.collection}:${finding.id}:${finding.check}:${finding.path}:${finding.locale ?? ""}`,
             check: finding.check,
@@ -46,6 +52,7 @@ export async function ContentHealthView({ initPageResult, params, searchParams,
             ...(withAssistant.has(finding.collection)
                 ? { askHref: editURL(adminRoute, finding, ASK[language][finding.check](finding)) }
                 : {}),
+            ...(batchable ? { batchTarget: batchTarget(finding) } : {}),
         };
     });
     const checks = result.checks.map((check) => ({
@@ -63,7 +70,7 @@ export async function ContentHealthView({ initPageResult, params, searchParams,
         }))
         : [];
     // Payload wraps only its own views in the Admin shell; a custom view brings nav and header itself.
-    return (_jsx(DefaultTemplate, { i18n: req.i18n, locale: locale, params: params, payload: req.payload, permissions: permissions, req: req, searchParams: searchParams, user: req.user ?? undefined, visibleEntities: visibleEntities, children: _jsxs(Gutter, { className: "content-health-list", children: [_jsx(SetStepNav, { nav: [{ label: copy.title }] }), _jsxs("header", { className: "content-health-list__header", children: [_jsx("h1", { children: copy.title }), _jsx("p", { className: "content-health-list__intro", children: copy.intro })] }), _jsx(WorkList, { checks: checks, collections: collections, initialFilters: readFilters(searchParams), language: language, locales: locales, rows: rows }), result.problems.length ? (_jsx("ul", { className: "content-health-list__problems", children: result.problems.map((problem) => (_jsx("li", { children: problem }, problem))) })) : null] }) }));
+    return (_jsx(DefaultTemplate, { i18n: req.i18n, locale: locale, params: params, payload: req.payload, permissions: permissions, req: req, searchParams: searchParams, user: req.user ?? undefined, visibleEntities: visibleEntities, children: _jsxs(Gutter, { className: "content-health-list", children: [_jsx(SetStepNav, { nav: [{ label: copy.title }] }), _jsxs("header", { className: "content-health-list__header", children: [_jsx("h1", { children: copy.title }), _jsx("p", { className: "content-health-list__intro", children: copy.intro })] }), _jsx(WorkList, { adminRoute: adminRoute, batchAsk: batchAsk, checks: checks, collections: collections, initialFilters: readFilters(searchParams), language: language, locales: locales, rows: rows }), result.problems.length ? (_jsx("ul", { className: "content-health-list__problems", children: result.problems.map((problem) => (_jsx("li", { children: problem }, problem))) })) : null] }) }));
 }
 /** By check, then document, then locale, so a document's locales sit together. */
 function sortFindings(findings) {

package/dist/view/WorkList.d.ts

@@ -19,12 +19,17 @@ export type WorkListRow = {
     href: string;
     /** The same with a prompt for the editor assistant; only where the assistant works. */
     askHref?: string;
+    /** The finding as one document of a batch; only where the assistant allows batch changes. */
+    batchTarget?: string;
 };
 /**
  * The findings with filters on check, collection and locale. Filters apply in the browser and are
  * kept in the address, so the view can be linked to and reloaded with them.
  */
-export declare function WorkList({ checks, collections, initialFilters, language, locales, rows, }: {
+export declare function WorkList({ adminRoute, batchAsk, checks, collections, initialFilters, language, locales, rows, }: {
+    adminRoute: string;
+    /** The assistant's prompt per check that it can fix in many documents at once. */
+    batchAsk: Partial<Record<CheckId, string>>;
     checks: WorkListOption[];
     collections: WorkListOption[];
     initialFilters: ListFilters;

package/dist/view/WorkList.js

@@ -3,23 +3,27 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button, Link } from "@payloadcms/ui";
 import { useMemo, useState } from "react";
 import { LIST_COPY } from "../copy.js";
-import { filterQuery, matchesFilters } from "../links.js";
+import { BATCH_CHECKS, batchURL, filterQuery, MAX_BATCH_TARGETS, matchesFilters, } from "../links.js";
 /**
  * The findings with filters on check, collection and locale. Filters apply in the browser and are
  * kept in the address, so the view can be linked to and reloaded with them.
  */
-export function WorkList({ checks, collections, initialFilters, language, locales, rows, }) {
+export function WorkList({ adminRoute, batchAsk, checks, collections, initialFilters, language, locales, rows, }) {
     const copy = LIST_COPY[language];
     const [filters, setFilters] = useState(initialFilters);
     const shown = useMemo(() => rows.filter((row) => matchesFilters(row, filters)), [rows, filters]);
     const documents = new Set(shown.map((row) => row.href.split("?")[0])).size;
     const filtered = Boolean(filters.check || filters.collection || filters.locale);
+    // One check at a time: the assistant fixes a batch with one prompt.
+    const ask = filters.check && BATCH_CHECKS[filters.check] ? batchAsk[filters.check] : undefined;
+    const batch = ask ? shown.flatMap((row) => (row.batchTarget ? [row.batchTarget] : [])) : [];
+    const batchHref = ask && batch.length > 1 ? batchURL(adminRoute, filters, batch, ask) : undefined;
     const update = (next) => {
         setFilters(next);
         const query = filterQuery(next);
         window.history.replaceState(window.history.state, "", `${window.location.pathname}${query ? `?${query}` : ""}`);
     };
-    return (_jsxs("div", { className: "content-health-list__body", children: [_jsxs("div", { className: "content-health-list__filters", children: [_jsx(Filter, { label: copy.check, all: copy.all, onChange: (check) => update({ ...filters, check: check }), options: checks, value: filters.check }), collections.length > 1 ? (_jsx(Filter, { label: copy.collection, all: copy.all, onChange: (collection) => update({ ...filters, collection }), options: collections, value: filters.collection })) : null, locales.length > 1 ? (_jsx(Filter, { label: copy.locale, all: copy.all, onChange: (locale) => update({ ...filters, locale }), options: locales, value: filters.locale })) : null, filtered ? (_jsx(Button, { buttonStyle: "subtle", margin: false, onClick: () => update({}), size: "small", children: copy.clear })) : null] }), _jsx("p", { className: "content-health-list__summary", "aria-live": "polite", children: shown.length ? copy.summary(shown.length, documents) : null }), shown.length ? (_jsx("ul", { className: "content-health-list__rows", children: shown.map((row) => (_jsxs("li", { className: "content-health-list__row", children: [_jsxs("div", { className: "content-health-list__what", children: [_jsx("span", { className: "content-health-list__check", children: row.checkLabel }), row.detail ? (_jsx("span", { className: "content-health-list__detail", children: row.detail })) : null] }), _jsxs("div", { className: "content-health-list__document", children: [_jsx(Link, { href: row.href, prefetch: false, children: row.title }), row.locale ? (_jsx("span", { className: "content-health-list__pill", children: row.locale })) : null, row.draft ? (_jsx("span", { className: "content-health-list__pill content-health-list__pill--draft", children: copy.draft })) : null] }), _jsx("div", { className: "content-health-list__actions", children: row.askHref ? (_jsx(Button, { buttonStyle: "secondary", el: "link", margin: false, size: "small", url: row.askHref, children: copy.fix })) : null })] }, row.key))) })) : (_jsx("p", { className: "content-health-list__empty", children: filtered ? copy.noneFiltered : copy.none }))] }));
+    return (_jsxs("div", { className: "content-health-list__body", children: [_jsxs("div", { className: "content-health-list__filters", children: [_jsx(Filter, { label: copy.check, all: copy.all, onChange: (check) => update({ ...filters, check: check }), options: checks, value: filters.check }), collections.length > 1 ? (_jsx(Filter, { label: copy.collection, all: copy.all, onChange: (collection) => update({ ...filters, collection }), options: collections, value: filters.collection })) : null, locales.length > 1 ? (_jsx(Filter, { label: copy.locale, all: copy.all, onChange: (locale) => update({ ...filters, locale }), options: locales, value: filters.locale })) : null, filtered ? (_jsx(Button, { buttonStyle: "subtle", margin: false, onClick: () => update({}), size: "small", children: copy.clear })) : null] }), _jsxs("div", { className: "content-health-list__summary", children: [_jsx("p", { "aria-live": "polite", children: shown.length ? copy.summary(shown.length, documents) : null }), batchHref ? (_jsx(Button, { buttonStyle: "primary", el: "link", margin: false, size: "small", url: batchHref, children: copy.fixMany(Math.min(batch.length, MAX_BATCH_TARGETS), batch.length) })) : null] }), shown.length ? (_jsx("ul", { className: "content-health-list__rows", children: shown.map((row) => (_jsxs("li", { className: "content-health-list__row", children: [_jsxs("div", { className: "content-health-list__what", children: [_jsx("span", { className: "content-health-list__check", children: row.checkLabel }), row.detail ? (_jsx("span", { className: "content-health-list__detail", children: row.detail })) : null] }), _jsxs("div", { className: "content-health-list__document", children: [_jsx(Link, { href: row.href, prefetch: false, children: row.title }), row.locale ? (_jsx("span", { className: "content-health-list__pill", children: row.locale })) : null, row.draft ? (_jsx("span", { className: "content-health-list__pill content-health-list__pill--draft", children: copy.draft })) : null] }), _jsx("div", { className: "content-health-list__actions", children: row.askHref ? (_jsx(Button, { buttonStyle: "secondary", el: "link", margin: false, size: "small", url: row.askHref, children: copy.fix })) : null })] }, row.key))) })) : (_jsx("p", { className: "content-health-list__empty", children: filtered ? copy.noneFiltered : copy.none }))] }));
 }
 function Filter({ all, label, onChange, options, value, }) {
     return (_jsxs("label", { className: "content-health-list__filter", children: [_jsx("span", { children: label }), _jsxs("select", { onChange: (event) => onChange(event.target.value || undefined), value: value ?? "", children: [_jsx("option", { value: "", children: all }), options.map((option) => (_jsx("option", { value: option.value, children: option.label }, option.value)))] })] }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simmalugnt-se/payload-content-health",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Content health checks and dashboard widgets for Payload Admin: alt texts, SEO fields and more",
   "keywords": [
     "payload",