@focus-reactive/payload-plugin-translator 0.7.1 → 0.8.0

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 schema map and provenance
+ * store factory ride along for the staleness endpoints.
  */
 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 schema map and provenance
+ * store factory ride along for the staleness endpoints.
  */ export function useDocTranslationApi(ctx) {
     ctx.addEndpoints(createTranslationRoutes({
         taskRunnerFactory: ctx.taskRunnerFactory,
@@ -11,7 +12,9 @@ import { createTranslationRoutes } from "../../server/features/createTranslation
             availableCollections: new Set(ctx.collections.map((collection)=>collection.slug))
         },
         access: ctx.access,
-        basePath: ctx.basePath
+        basePath: ctx.basePath,
+        schemaMap: ctx.schemaMap,
+        provenanceStoreFactory: ctx.provenanceStoreFactory
     }));
 }
 

package/dist/core/field-traversal/types.d.ts

@@ -11,13 +11,15 @@ export interface BlockLike {
 }
 /**
  * A tab as this layer needs to read it: an optional `name` (present → it opens a data boundary;
- * absent → it flattens into the parent scope) and its child `fields`. Payload's `Tab`
- * (`NamedTab | UnnamedTab`) is assignable to this.
+ * absent → it flattens into the parent scope), its child `fields`, and `localized` (a *named* tab
+ * may be `localized`, partitioning its subtree per locale — Payload's sanitizer propagates it the
+ * same as a group). Payload's `Tab` (`NamedTab | UnnamedTab`) is assignable to this.
  *
  * @public
  */
 export interface TabLike {
     name?: string;
+    localized?: boolean;
     fields: FieldLike[];
 }
 /**

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/core/translation-pipeline/stages/data-reconciler/DataReconciler.js

@@ -5,9 +5,9 @@ const asObject = (value)=>isObject(value) ? value : {};
 /**
  * Reconcile walker: produces the full document shape from source + target, with target
  * priority (source fills empty target slots). Iteration is driven by `source`; a field with
- * no source value is dropped, `id` is stripped from array/block elements (Postgres rejects it
- * on update), `blockType` is preserved, and non-object array items / unknown blocks pass
- * through unchanged.
+ * no source value is dropped, `blockType` is preserved, non-object array items / unknown blocks
+ * pass through unchanged, and array/block `id` is kept for shared rows but stripped for per-locale
+ * rows (see {@link Cursor.sharedRow} — the data-loss-critical bit).
  *
  * Array/block elements are paired with their target counterpart by `id`, not by position (see
  * {@link matchElementById}); output order always follows `source`.
@@ -15,9 +15,12 @@ const asObject = (value)=>isObject(value) ? value : {};
     enterObject (field, cursor) {
         const sourceValue = cursor.source[field.name];
         if (!isObject(sourceValue)) return "skip"; // undefined / non-object source → drop the field
+        // A localized group or named tab partitions its whole subtree per locale → descendants are
+        // per-locale rows (Payload's sanitizer propagates `tab.localized` the same as a group).
         return {
             source: sourceValue,
-            target: asObject(cursor.target[field.name])
+            target: asObject(cursor.target[field.name]),
+            sharedRow: cursor.sharedRow && !field.localized
         };
     },
     enterList (field, cursor) {
@@ -26,6 +29,8 @@ const asObject = (value)=>isObject(value) ? value : {};
         const targetValue = cursor.target[field.name];
         const targetArr = Array.isArray(targetValue) ? targetValue : [];
         const isBlocks = field.type === "blocks";
+        // Elements are shared rows only when this container AND every ancestor is non-localized.
+        const childShared = cursor.sharedRow && !field.localized;
         const children = [];
         sourceValue.forEach((item, index)=>{
             if (!isObject(item)) return; // non-object element → passthrough (rebuilt in combine)
@@ -35,7 +40,8 @@ const asObject = (value)=>isObject(value) ? value : {};
             children.push({
                 cursor: {
                     source: item,
-                    target: matchElementById(targetArr, item, isBlocks)
+                    target: matchElementById(targetArr, item, isBlocks),
+                    sharedRow: childShared
                 },
                 fields,
                 key: index
@@ -58,13 +64,29 @@ const asObject = (value)=>isObject(value) ? value : {};
                     child.key,
                     child.out
                 ]));
-            return sourceArr.map((item, index)=>byIndex.has(index) ? byIndex.get(index) : item);
+            // Passthrough items (unknown blockType / unresolved fields) never reach the element branch's
+            // id guard, so apply the same rule here: strip a per-locale row's id to avoid an insert
+            // collision. Elements are shared only when this container and every ancestor is non-localized.
+            const childShared = cursor.sharedRow && !container.field.localized;
+            return sourceArr.map((item, index)=>{
+                if (byIndex.has(index)) return byIndex.get(index);
+                if (!childShared && isObject(item) && item.id != null) {
+                    const { id: _dropped, ...rest } = item;
+                    return rest;
+                }
+                return item;
+            });
         }
         const result = {};
         for (const child of children)result[child.key] = child.out;
-        // Block elements keep their blockType; id is intentionally stripped (Postgres rejects it on update).
-        if (container.kind === "element" && container.field.type === "blocks") {
-            result.blockType = cursor.source.blockType;
+        if (container.kind === "element") {
+            // Block elements keep their blockType.
+            if (container.field.type === "blocks") result.blockType = cursor.source.blockType;
+            // Keep `id` only for a shared (non-localized, no localized ancestor) row so Payload updates it
+            // in place; stripping it there makes Payload recreate the row and wipe other locales. Under a
+            // localized container/ancestor the rows are per-locale, so the id is dropped to avoid an
+            // insert collision with the source locale's row. Guard against writing `id: undefined`.
+            if (cursor.sharedRow && cursor.source.id != null) result.id = cursor.source.id;
         }
         return result;
     }
@@ -88,7 +110,8 @@ const asObject = (value)=>isObject(value) ? value : {};
    */ reconcile(sourceData, targetData) {
         const root = {
             source: sourceData,
-            target: targetData ?? {}
+            target: targetData ?? {},
+            sharedRow: true
         };
         return walkFields(this.schema, root, reconcileWalker) ?? {};
     }

package/dist/plugin.js

@@ -87,7 +87,8 @@ import { normalizePath } from "./server/shared";
                 access,
                 taskRunnerFactory,
                 schemaMap,
-                translationProvider
+                translationProvider,
+                provenanceStoreFactory
             });
             for (const level of activeLevels)level.extend(builder);
             builder.addConfigModifier(runnerConfigModifier);

package/dist/server/features/_lib/sourceDocument.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionSlug, Payload } from "payload";
+/**
+ * Fetch a document's source-locale data with the exact shape the provenance fingerprint depends on
+ * (`depth: 0`, the given locale). Shared by the translation **write** path (which fingerprints the
+ * source it just translated) and the staleness **read** path (which re-fingerprints the live source),
+ * so the fingerprint baseline can never drift between the two — the single biggest correctness trap in
+ * staleness detection is thus enforced structurally, not by a comment.
+ */
+export declare function fetchSourceDocument(payload: Payload, collection: CollectionSlug, id: string, locale: string): Promise<import("payload").JsonObject & import("payload").TypeWithID>;

package/dist/server/features/_lib/sourceDocument.js

@@ -0,0 +1,16 @@
+/**
+ * Fetch a document's source-locale data with the exact shape the provenance fingerprint depends on
+ * (`depth: 0`, the given locale). Shared by the translation **write** path (which fingerprints the
+ * source it just translated) and the staleness **read** path (which re-fingerprints the live source),
+ * so the fingerprint baseline can never drift between the two — the single biggest correctness trap in
+ * staleness detection is thus enforced structurally, not by a comment.
+ */ export function fetchSourceDocument(payload, collection, id, locale) {
+    return payload.findByID({
+        collection,
+        id,
+        locale,
+        depth: 0
+    });
+}
+
+//# sourceMappingURL=sourceDocument.js.map