@focus-reactive/payload-plugin-translator 0.7.2 → 0.8.1

package/dist/client/shared/ui/Loading/styles.module.scss

@@ -31,56 +31,49 @@
   }
 
   &__bars {
-    display: grid;
-    gap: 7px;
+    display: flex;
     align-items: center;
 
-    &_small {
-      grid-template-columns: 1fr 1fr;
+    // Gap tightens with size so a small control's bars don't read as scattered.
+    &_sm {
+      gap: 4px;
     }
 
-    &_medium {
-      grid-template-columns: 1fr 1fr 1fr 1fr 1fr;
+    &_md {
+      gap: 6px;
+    }
+
+    &_lg {
+      gap: 7px;
     }
   }
 
   &__bar {
     background-color: currentColor;
+    width: 2px;
 
-    &_size-small {
-      height: 10px;
-      width: 2px;
+    &_size-sm {
+      height: 9px;
     }
 
-    &_size-medium {
-      height: 15px;
-      width: 2px;
-    }
-
-    &:nth-child(1) {
-      transform: translateY(0);
-      animation: animate-bar--odd 1.25s infinite;
+    &_size-md {
+      height: 12px;
     }
 
-    &:nth-child(2) {
-      transform: translateY(-2px);
-      animation: animate-bar--even 1.25s infinite;
+    &_size-lg {
+      height: 15px;
     }
 
-    &:nth-child(3) {
+    // Neighbouring bars swing in opposition, regardless of how many there are.
+    &:nth-child(odd) {
       transform: translateY(0);
       animation: animate-bar--odd 1.25s infinite;
     }
 
-    &:nth-child(4) {
+    &:nth-child(even) {
       transform: translateY(-2px);
       animation: animate-bar--even 1.25s infinite;
     }
-
-    &:nth-child(5) {
-      transform: translateY(0);
-      animation: animate-bar--odd 1.25s infinite;
-    }
   }
 
   &__text {

package/dist/client/shared/ui/Popup/Popup.js

@@ -15,6 +15,9 @@ function Popup({ open, children, onOpenChange, $trigger, $align, $side, onOpenAu
                     sideOffset: 8,
                     side: $side,
                     align: $align,
+                    // Keep a gap from the viewport edges so the popup never sticks to the screen border —
+                    // Radix shifts it inward to preserve this padding.
+                    collisionPadding: 12,
                     className: style.popover,
                     onOpenAutoFocus: onOpenAutoFocus,
                     children: children

package/dist/client/shared/ui/Select/Select.js

@@ -5,7 +5,7 @@ import styles from "./styles.module.scss";
 const sizes = {
     sm: {
         height: "24px",
-        paddingInline: "0.25rem",
+        paddingInline: "0.5rem",
         fontSize: "0.875rem"
     },
     md: {

package/dist/client/shared/ui/form/FormSelect/FormSelect.js

@@ -78,6 +78,7 @@ export default function FormSelect({ name, required, options, label, description
     return /*#__PURE__*/ _jsxs(Label, {
         className: className,
         label: label,
+        $size: size,
         children: [
             selectElement,
             errorAndDescription

package/dist/client/widgets/bulk-translation-dashboard/ui/BulkTranslationDashboard.js

@@ -3,13 +3,14 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { toast, useLocale, useSelection } from "@payloadcms/ui";
 import { SelectAllStatus } from "@payloadcms/ui/providers/Selection";
 import { useEffect, useMemo } from "react";
-import { TranslationsApi } from "../../../entities/translation";
+import { deriveCollectionPanelStatus, TranslationsApi } from "../../../entities/translation";
 import { CollectionTranslationForm, FORM_FIELDS } from "../../../features/collection-translation-form";
 import { CollectionTranslationFormModel } from "../../../features/collection-translation-form/index.client";
 import CollectionTranslationPopup from "../../../features/collection-translation-popup";
 import { CollectionTranslationProgress } from "../../../features/collection-translation-progress";
 import { handleFormError } from "../../../shared/lib/forms/handle-form-error";
 import { useCollectionDashboardUrlParams } from "../../../shared/lib/payload/hooks/useCollectionDashboardUrlParams";
+import styles from "./styles.module.scss";
 export default function BulkTranslationDashboard({ hasDrafts }) {
     const locale = useLocale();
     const { collection } = useCollectionDashboardUrlParams();
@@ -38,7 +39,10 @@ export default function BulkTranslationDashboard({ hasDrafts }) {
     });
     const selectAll = documentsSelection.selectAll === SelectAllStatus.AllAvailable;
     const selectedCount = selectAll ? documentsSelection.totalDocs : documentsSelection.count;
-    const translationInProgress = !!(collectionTranslationApi.data?.pending.length || collectionTranslationApi.data?.running.length);
+    const status = collectionTranslationApi.data;
+    const panelStatus = deriveCollectionPanelStatus(status);
+    const hasAnyCount = !!(status && (status.completed.length || status.failed.length || status.running.length || status.pending.length));
+    const showStatus = collectionTranslationApi.isPending || hasAnyCount;
     const handleSubmit = async (formData)=>{
         try {
             await queueTranslationApi.mutateAsync({
@@ -51,25 +55,41 @@ export default function BulkTranslationDashboard({ hasDrafts }) {
         }
     };
     return /*#__PURE__*/ _jsxs(CollectionTranslationPopup, {
-        translationInProgress: translationInProgress,
+        status: panelStatus,
         selectedCount: selectedCount,
         children: [
-            /*#__PURE__*/ _jsx("h3", {
-                children: "Bulk Translation Dashboard"
+            /*#__PURE__*/ _jsx("h4", {
+                className: styles.title,
+                children: "Bulk translation"
             }),
-            /*#__PURE__*/ _jsx("p", {
-                children: "Translate multiple documents at once using AI. Select the records you want to translate on the collection dashboard, then configure your translation settings here."
+            /*#__PURE__*/ _jsxs("section", {
+                className: styles.section,
+                children: [
+                    /*#__PURE__*/ _jsx("h5", {
+                        className: styles.eyebrow,
+                        children: "Translate"
+                    }),
+                    /*#__PURE__*/ _jsx(CollectionTranslationForm, {
+                        form: form,
+                        onSubmit: handleSubmit,
+                        selectedCount: selectedCount,
+                        hasDrafts: hasDrafts
+                    })
+                ]
             }),
-            /*#__PURE__*/ _jsx(CollectionTranslationForm, {
-                form: form,
-                onSubmit: handleSubmit,
-                selectedCount: selectedCount,
-                hasDrafts: hasDrafts
-            }),
-            /*#__PURE__*/ _jsx(CollectionTranslationProgress, {
-                collection: collection,
-                data: collectionTranslationApi.data,
-                isPending: collectionTranslationApi.isPending
+            showStatus && /*#__PURE__*/ _jsxs("section", {
+                className: `${styles.section} ${styles["section--status"]}`,
+                children: [
+                    /*#__PURE__*/ _jsx("h5", {
+                        className: styles.eyebrow,
+                        children: "Status"
+                    }),
+                    /*#__PURE__*/ _jsx(CollectionTranslationProgress, {
+                        collection: collection,
+                        data: collectionTranslationApi.data,
+                        isPending: collectionTranslationApi.isPending
+                    })
+                ]
             })
         ]
     });

package/dist/client/widgets/bulk-translation-dashboard/ui/styles.module.scss

@@ -0,0 +1,27 @@
+.title {
+  margin: 0;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--theme-text, #222);
+}
+
+.section {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+// One eyebrow style shared by every section header, so the sections read as one system.
+.eyebrow {
+  margin: 0;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--theme-elevation-500, #8c8c8c);
+}
+
+.section--status {
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--theme-elevation-100, #e6e6e6);
+}

package/dist/client/widgets/translate-document/ui/TranslateDocument.js

@@ -2,20 +2,19 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { toast, useLocale } from "@payloadcms/ui";
 import { useEffect, useMemo } from "react";
-import { CompletedTranslationStatus, TranslationsApi } from "../../../entities/translation";
+import { buildTranslationStatusRows, derivePanelStatus, TranslationsApi, TranslationStatusList } from "../../../entities/translation";
 import { OpenDocumentTranslationPopup } from "../../../features/open-document-translation-popup";
 import { DocumentTranslationForm, FORM_FIELDS } from "../../../features/translate-document-form";
 import { DocumentTranslationFormModel } from "../../../features/translate-document-form/index.client";
 import { handleFormError } from "../../../shared/lib/forms/handle-form-error";
 import { useCollectionDocumentUrlParams } from "../../../shared/lib/payload/hooks/useCollectionDocumentUrlParams";
-import { DocumentTranslationProgressFailed } from "../../../features/document-translation-progress-failed";
-import { DocumentTranslationProgressRunning } from "../../../features/document-translation-progress-running";
-import { DocumentTranslationProgressPending } from "../../../features/document-translation-progress-pending";
+import styles from "./styles.module.scss";
 const TranslateDocument = ({ hasDrafts })=>{
     const locale = useLocale();
     const params = useCollectionDocumentUrlParams();
     const queueTranslationApi = TranslationsApi.useQueueDocumentTranslation();
     const { data, error, isLoading } = TranslationsApi.useDocumentTranslation(params);
+    const { data: staleness } = TranslationsApi.useDocumentStaleness(params);
     useEffect(()=>{
         if (error) {
             toast.error(error.message);
@@ -23,6 +22,24 @@ const TranslateDocument = ({ hasDrafts })=>{
     }, [
         error
     ]);
+    const staleLocales = useMemo(()=>(staleness?.locales ?? []).filter((l)=>l.is_stale).map((l)=>l.target_lng), [
+        staleness
+    ]);
+    // The panel trigger shows one aggregate marker; the popup shows the full per-locale list.
+    const panelStatus = useMemo(()=>derivePanelStatus({
+            runStatus: data?.status,
+            staleLocales
+        }), [
+        data?.status,
+        staleLocales
+    ]);
+    const statusRows = useMemo(()=>buildTranslationStatusRows({
+            staleness,
+            run: data
+        }), [
+        staleness,
+        data
+    ]);
     const initialValues = useMemo(()=>({
             [FORM_FIELDS.SOURCE_LNG]: locale.code,
             [FORM_FIELDS.HIDDEN_COLLECTION_SLUG]: params.collection,
@@ -48,38 +65,47 @@ const TranslateDocument = ({ hasDrafts })=>{
             handleFormError(e, form);
         }
     };
-    return /*#__PURE__*/ _jsxs(_Fragment, {
-        children: [
-            /*#__PURE__*/ _jsx(OpenDocumentTranslationPopup, {
-                isLoading: isLoading,
-                children: ({ close })=>/*#__PURE__*/ _jsxs(_Fragment, {
+    // Vertical stack: title → Translate (form) → Status (unified per-locale list). No columns, no
+    // corner chip — one consistent system so the popup stays calm as the plugin grows.
+    return /*#__PURE__*/ _jsx(OpenDocumentTranslationPopup, {
+        isLoading: isLoading,
+        status: panelStatus,
+        children: ({ close })=>/*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx("h4", {
+                        className: styles.title,
+                        children: "Document translation"
+                    }),
+                    /*#__PURE__*/ _jsxs("section", {
+                        className: styles.section,
                         children: [
-                            /*#__PURE__*/ _jsx("h4", {
-                                children: "Document Translation"
+                            /*#__PURE__*/ _jsx("h5", {
+                                className: styles.eyebrow,
+                                children: "Translate"
                             }),
                             /*#__PURE__*/ _jsx(DocumentTranslationForm, {
                                 form: form,
-                                onSubmit: (data)=>handleSubmit(data, close),
+                                onSubmit: (formData)=>handleSubmit(formData, close),
                                 hasDrafts: hasDrafts
                             })
                         ]
+                    }),
+                    statusRows.length > 0 && /*#__PURE__*/ _jsxs("section", {
+                        className: `${styles.section} ${styles["section--status"]}`,
+                        children: [
+                            /*#__PURE__*/ _jsx("h5", {
+                                className: styles.eyebrow,
+                                children: "Status"
+                            }),
+                            /*#__PURE__*/ _jsx(TranslationStatusList, {
+                                rows: statusRows,
+                                collection: params.collection,
+                                id: params.id
+                            })
+                        ]
                     })
-            }),
-            data?.status === "completed" && /*#__PURE__*/ _jsx(CompletedTranslationStatus, {
-                sourceLocale: data.input.source_lng,
-                targetLocale: data.input.target_lng,
-                completed_at: data.completed_at
-            }),
-            data?.status === "failed" && /*#__PURE__*/ _jsx(DocumentTranslationProgressFailed, {
-                data: data
-            }),
-            data?.status === "running" && /*#__PURE__*/ _jsx(DocumentTranslationProgressRunning, {
-                data: data
-            }),
-            data?.status === "pending" && /*#__PURE__*/ _jsx(DocumentTranslationProgressPending, {
-                data: data
+                ]
             })
-        ]
     });
 };
 export default TranslateDocument;

package/dist/client/widgets/translate-document/ui/styles.module.scss

@@ -0,0 +1,27 @@
+.title {
+  margin: 0;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--theme-text, #222);
+}
+
+.section {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+// One eyebrow style shared by every section header, so the sections read as one system.
+.eyebrow {
+  margin: 0;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--theme-elevation-500, #8c8c8c);
+}
+
+.section--status {
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--theme-elevation-100, #e6e6e6);
+}

package/dist/composition/levels/useDocTranslationApi.d.ts

@@ -1,8 +1,9 @@
 import type { LevelContext } from "../../server/modules/translation-levels";
 /**
- * Contribute the runner-agnostic document-translation API — the shared 6-route
+ * Contribute the runner-agnostic document-translation API — the shared route
  * bundle, bound to the level context's runner. Both `documentLevel` and
  * `collectionLevel` call this; the plugin deduplicates the endpoints by method +
- * path, so the bundle registers exactly once.
+ * path, so the bundle registers exactly once. The provenance service factory
+ * rides along for the staleness endpoints (its schema lives inside the service).
  */
 export declare function useDocTranslationApi(ctx: LevelContext): void;

package/dist/composition/levels/useDocTranslationApi.js

@@ -1,9 +1,10 @@
 import { createTranslationRoutes } from "../../server/features/createTranslationRoutes";
 /**
- * Contribute the runner-agnostic document-translation API — the shared 6-route
+ * Contribute the runner-agnostic document-translation API — the shared route
  * bundle, bound to the level context's runner. Both `documentLevel` and
  * `collectionLevel` call this; the plugin deduplicates the endpoints by method +
- * path, so the bundle registers exactly once.
+ * path, so the bundle registers exactly once. The provenance service factory
+ * rides along for the staleness endpoints (its schema lives inside the service).
  */ export function useDocTranslationApi(ctx) {
     ctx.addEndpoints(createTranslationRoutes({
         taskRunnerFactory: ctx.taskRunnerFactory,
@@ -11,7 +12,8 @@ import { createTranslationRoutes } from "../../server/features/createTranslation
             availableCollections: new Set(ctx.collections.map((collection)=>collection.slug))
         },
         access: ctx.access,
-        basePath: ctx.basePath
+        basePath: ctx.basePath,
+        provenanceServiceFactory: ctx.provenanceServiceFactory
     }));
 }
 

package/dist/core/provenance/ProvenanceStore.interface.d.ts

@@ -88,6 +88,24 @@ export interface ProvenanceStore {
      * @returns The stored record, or `null` if none exists.
      */
     find(key: ProvenanceKey): Promise<TranslationProvenanceRecord | null>;
+    /**
+     * List every record for a document — one per translated target locale. Backs #50's per-locale
+     * staleness read for a single document panel.
+     *
+     * @param collectionSlug - Slug of the translated document's collection.
+     * @param documentId - Stringified id of the translated document.
+     * @returns All provenance receipts for the document (empty when none exist).
+     */
+    findByDocument(collectionSlug: string, documentId: string): Promise<TranslationProvenanceRecord[]>;
+    /**
+     * Acknowledge the current source drift for one locale without re-translating (#50's dismiss):
+     * persist `dismissedFingerprint` so the indicator hides until the source changes again. No-op if
+     * the key has no record.
+     *
+     * @param key - The `(collectionSlug, documentId, targetLocale)` identity to dismiss.
+     * @param dismissedFingerprint - The current source fingerprint being acknowledged.
+     */
+    dismiss(key: ProvenanceKey, dismissedFingerprint: string): Promise<void>;
     /**
      * Delete every record for a document (all target locales). Used to cascade-clean when the source
      * document is deleted.

package/dist/core/provenance/index.d.ts

@@ -1 +1,2 @@
 export type { ProvenanceKey, ProvenanceStore, TranslationProvenanceRecord, } from "./ProvenanceStore.interface";
+export { isRecordStale } from "./staleness";

package/dist/core/provenance/index.js

@@ -1,5 +1,5 @@
 // Provenance contracts (port + record types) only — payload-free. The Payload-backed store lives
 // in the plugin (src/server/modules/provenance), outside the core.
-export { };
+export { isRecordStale } from "./staleness";
 
 //# sourceMappingURL=index.js.map

package/dist/core/provenance/staleness.d.ts

@@ -0,0 +1,19 @@
+import type { TranslationProvenanceRecord } from "./ProvenanceStore.interface";
+/**
+ * Whether a translated locale is out of date relative to its source — the #50 rule, in one place.
+ *
+ * A record is stale when the current source fingerprint differs from the one the translation was
+ * derived from (`record.sourceFingerprint`) **and** the editor has not acknowledged that exact drift
+ * (`record.dismissedFingerprint`). Dismissing sets `dismissedFingerprint` to the current fingerprint,
+ * so the indicator hides until the source changes again (a new fingerprint no longer matches the
+ * dismissed one). `dismissedFingerprint` is `null` until the first dismiss, in which case the check
+ * reduces to a plain source-drift comparison.
+ *
+ * Pure and payload-free so the staleness contract is testable without a database; the server handler
+ * supplies `currentFingerprint` via {@link computeSourceFingerprint} on the live source document.
+ *
+ * @param record - The stored provenance receipt for one `(collection, document, targetLocale)`.
+ * @param currentFingerprint - `computeSourceFingerprint` of the source document right now.
+ * @returns `true` when the target locale is out of date and not dismissed.
+ */
+export declare function isRecordStale(record: TranslationProvenanceRecord, currentFingerprint: string): boolean;

package/dist/core/provenance/staleness.js

@@ -0,0 +1,21 @@
+/**
+ * Whether a translated locale is out of date relative to its source — the #50 rule, in one place.
+ *
+ * A record is stale when the current source fingerprint differs from the one the translation was
+ * derived from (`record.sourceFingerprint`) **and** the editor has not acknowledged that exact drift
+ * (`record.dismissedFingerprint`). Dismissing sets `dismissedFingerprint` to the current fingerprint,
+ * so the indicator hides until the source changes again (a new fingerprint no longer matches the
+ * dismissed one). `dismissedFingerprint` is `null` until the first dismiss, in which case the check
+ * reduces to a plain source-drift comparison.
+ *
+ * Pure and payload-free so the staleness contract is testable without a database; the server handler
+ * supplies `currentFingerprint` via {@link computeSourceFingerprint} on the live source document.
+ *
+ * @param record - The stored provenance receipt for one `(collection, document, targetLocale)`.
+ * @param currentFingerprint - `computeSourceFingerprint` of the source document right now.
+ * @returns `true` when the target locale is out of date and not dismissed.
+ */ export function isRecordStale(record, currentFingerprint) {
+    return currentFingerprint !== record.sourceFingerprint && currentFingerprint !== record.dismissedFingerprint;
+}
+
+//# sourceMappingURL=staleness.js.map

package/dist/plugin.js

@@ -1,19 +1,9 @@
 import { CacheProviderExport } from "./client/app/cache/CacheProvider.export";
-import { DEFAULT_PROVENANCE_SLUG, PayloadProvenanceStore, assertProvenanceSlugFree, injectProvenanceCleanup, isProvenanceCollection, makeProvenanceCollection } from "./server/modules/provenance";
-import { TranslateDocumentHandler } from "./server/features/translate-document";
-import { LifecycleNotifier, taskFromHandlerInput, withQueuedNotification } from "./server/modules/lifecycle";
+import { configureProvenance } from "./server/modules/provenance";
+import { wireTranslateRunner } from "./server/features/translate-document";
 import { documentLevel, collectionLevel } from "./composition/levels";
 import { PluginConfigBuilder } from "./server/modules/translation-levels/PluginConfigBuilder";
 import { normalizePath } from "./server/shared";
-/**
- * Resolve the opt-in `provenance` config to a sidecar slug, or `null` when disabled.
- * `false`/omitted → off; `true` or `{}` → on with the default slug; `{ slug }` → on with that slug.
- */ function resolveProvenanceSlug(provenance) {
-    if (!provenance) return null;
-    if (provenance === true) return DEFAULT_PROVENANCE_SLUG;
-    // `||` (not `??`) so an empty/blank slug falls back to the default instead of silently disabling.
-    return provenance.slug || DEFAULT_PROVENANCE_SLUG;
-}
 /** @deprecated Use `translatorPlugin` function instead */ export class TranslateCollectionPlugin {
     pluginConfig;
     constructor(pluginConfig){
@@ -22,61 +12,30 @@ import { normalizePath } from "./server/shared";
     init() {
         return async (config)=>{
             const { access, translationProvider, runner, collections, levels, provenance, lifecycle, basePath: rawBasePath = "/translate" } = this.pluginConfig;
-            const lifecycleCallbacks = lifecycle ?? {};
-            // Build schema map from deep-cloned collections
-            // Deep clone is required because Payload mutates the original collection objects,
-            // removing `localized: true` from nested fields during sanitization.
-            // We use JSON round-trip instead of structuredClone because Lexical editor
-            // configs contain async functions that structuredClone cannot handle.
-            // TODO: Consider introducing a FieldLike interface with only the properties
-            // used by the pipeline (name, type, localized, fields, blocks, tabs, custom)
-            // to make the contract explicit and avoid reliance on JSON round-trip.
+            // Build schema map from deep-cloned collections.
+            // Deep clone is required because Payload mutates the original collection objects, removing
+            // `localized: true` from nested fields during sanitization. JSON round-trip (not
+            // structuredClone) because Lexical editor configs contain async functions structuredClone
+            // cannot handle.
+            // TODO: Consider introducing a FieldLike interface with only the properties used by the
+            // pipeline (name, type, localized, fields, blocks, tabs, custom) to make the contract explicit
+            // and avoid reliance on JSON round-trip.
             const schemaMap = new Map(collections.map((col)=>[
                     col.slug,
                     JSON.parse(JSON.stringify(col.fields))
                 ]));
             const collectionSlugs = new Set(schemaMap.keys());
             const basePath = normalizePath(rawBasePath);
-            const provenanceSlug = resolveProvenanceSlug(provenance);
-            if (provenanceSlug) {
-                const existing = (config.collections ?? []).filter((collection)=>!isProvenanceCollection(collection));
-                assertProvenanceSlugFree(provenanceSlug, existing);
-            }
-            const provenanceStoreFactory = provenanceSlug ? (p)=>new PayloadProvenanceStore(p, provenanceSlug) : undefined;
-            const translateHandler = new TranslateDocumentHandler(translationProvider, schemaMap, provenanceStoreFactory);
-            const runnerContext = {
-                handler: async (payload, input)=>{
-                    const notifier = new LifecycleNotifier(lifecycleCallbacks, payload.logger);
-                    const task = taskFromHandlerInput(input);
-                    try {
-                        await translateHandler.handle(payload, {
-                            collection: input.collection,
-                            collectionId: input.collectionId,
-                            sourceLng: input.sourceLng,
-                            targetLng: input.targetLng,
-                            strategy: input.strategy,
-                            publishOnTranslation: input.publishOnTranslation
-                        });
-                    } catch (error) {
-                        await notifier.failed(task, error);
-                        throw error; // rethrow so the runner marks the job failed
-                    }
-                    await notifier.completed(task);
-                },
+            // Each concern owns its own config-time wiring and exposes it uniformly; init() just composes.
+            const provenanceModule = configureProvenance(provenance, schemaMap);
+            const { taskRunnerFactory, configModifier: runnerConfigModifier } = wireTranslateRunner({
+                translationProvider,
+                schemaMap,
+                provenanceServiceFactory: provenanceModule.serviceFactory,
+                runner,
+                lifecycle: lifecycle ?? {},
                 collections: Array.from(collectionSlugs)
-            };
-            const runnerConfigModifier = runner.configure(runnerContext);
-            // Bind the context once so routes receive a self-sufficient factory: the
-            // runner needs no mutable per-instance handler state and create() has no
-            // "configure() must run first" ordering coupling (translator plan, 0c).
-            // When an `onQueued` callback is set, decorate the runner so `enqueue` fires it.
-            const taskRunnerFactory = {
-                create: (payload)=>{
-                    const taskRunner = runner.create(payload, runnerContext.handler);
-                    if (!lifecycleCallbacks.onQueued) return taskRunner;
-                    return withQueuedNotification(taskRunner, new LifecycleNotifier(lifecycleCallbacks, payload.logger));
-                }
-            };
+            });
             const activeLevels = levels ?? [
                 documentLevel(),
                 collectionLevel()
@@ -87,23 +46,12 @@ import { normalizePath } from "./server/shared";
                 access,
                 taskRunnerFactory,
                 schemaMap,
-                translationProvider
+                translationProvider,
+                provenanceServiceFactory: provenanceModule.serviceFactory
             });
             for (const level of activeLevels)level.extend(builder);
             builder.addConfigModifier(runnerConfigModifier);
-            if (provenanceSlug && provenanceStoreFactory) {
-                builder.addConfigModifier((cfg)=>{
-                    const alreadyAdded = cfg.collections?.some((collection)=>collection.slug === provenanceSlug && isProvenanceCollection(collection));
-                    if (!alreadyAdded) {
-                        cfg.collections = [
-                            ...cfg.collections ?? [],
-                            makeProvenanceCollection(provenanceSlug)
-                        ];
-                    }
-                    injectProvenanceCleanup(cfg, collectionSlugs, provenanceStoreFactory, provenanceSlug);
-                    return cfg;
-                });
-            }
+            builder.addConfigModifier(provenanceModule.configure(collectionSlugs));
             builder.addAdminProvider(new CacheProviderExport(basePath));
             // The single place the Payload config is mutated.
             return builder.applyTo(config);