@justanarthur/payload-plugin-translator 3.1.1 → 3.2.0

package/README.md

@@ -79,7 +79,7 @@ export const myResolver: TranslateResolver = {
 | `globals`     | `GlobalSlug[]`        | yes      | Globals to auto-translate.                                             |
 | `resolvers`   | `TranslateResolver[]` | yes      | Tried in order; first to succeed wins per chunk.                       |
 | `autoTranslate` | `boolean`           | no       | Default `true`. Set `false` to opt out of the auto-translate afterChange hook — useful when you drive translation manually via the `translateOperation` export. |
-| `autoTranslateMode` | `'missing' \| 'all'` | no | Default `'missing'`: a publish in the default locale fills empty fields in other locales and keeps existing translations and slugs. `'all'` re-translates everything. |
+| `autoTranslateMode` | `'missing' \| 'untranslated' \| 'all'` | no | Default `'missing'`: a publish in the default locale fills empty fields in other locales and keeps existing translations and slugs. `'untranslated'` also replaces fields that still hold the source copy. `'all'` re-translates everything. |
 | `review`      | `boolean`             | no       | Default `true`. Adds the `/admin/translations` review view, its endpoints and the hidden `translation-status` collection (needs a migration on postgres). |
 | `disabled`    | `boolean`             | no       | Skip the plugin entirely (no overrides, no jobs). Useful in tests.    |
 | `_options.additionalTraverseRichText` | function | no | Hook to extend rich-text traversal — see below.             |
@@ -128,6 +128,12 @@ With `review` on, **Translations** appears in the admin nav (`/admin/translation
   last auto-translate job and its error. Actions: *Translate missing fields*, *Re-translate all*,
   *Mark reviewed*.
 
+- **Bulk fix**: *Translate untranslated* queues one translate workflow per incomplete document,
+  for all locales or one, in `untranslated` mode (empty fields and fields still holding the source
+  copy; existing translations and slugs stay). Locales a pending job already covers are skipped.
+  The overview shows queued, running and failed jobs, and *Run a batch now* processes a few without
+  waiting for the job runner. Needs `autoTranslate` on, since that registers the jobs.
+
 The view only lists collections and globals the signed-in user can read, and the endpoints behind
 the actions require a user.
 

package/dist/client.d.ts

@@ -4,13 +4,25 @@ declare const CustomButtonWithTranslator: ({ type }: {
 	type: "publish" | "save";
 }) => Element_12xgc;
 import { JSX as JSX_1kxb2 } from "react";
+type Progress = {
+	pending: number;
+	running: number;
+	failed: number;
+} | null;
 type Element_12xgc2 = JSX_1kxb2["Element"];
+declare const BulkActions: ({ tab, locales, progress }: {
+	tab: string;
+	locales: string[];
+	progress: Progress;
+}) => Element_12xgc2;
+import { JSX as JSX_1kxb3 } from "react";
+type Element_12xgc3 = JSX_1kxb3["Element"];
 declare const ReviewActions: ({ entity, locale, reviewed }: {
 	entity: string;
 	locale: string;
 	reviewed: boolean;
-}) => Element_12xgc2;
-import { JSX as JSX_1kxb3 } from "react";
-type Element_12xgc3 = JSX_1kxb3["Element"];
-declare const TranslationsNavLink: () => Element_12xgc3;
-export { CustomButtonWithTranslator, ReviewActions, TranslationsNavLink, CustomButtonWithTranslator as default };
+}) => Element_12xgc3;
+import { JSX as JSX_1kxb4 } from "react";
+type Element_12xgc4 = JSX_1kxb4["Element"];
+declare const TranslationsNavLink: () => Element_12xgc4;
+export { BulkActions, CustomButtonWithTranslator, ReviewActions, TranslationsNavLink, CustomButtonWithTranslator as default };

package/dist/client.js

@@ -315,14 +315,125 @@ var CustomButtonWithTranslator = ({ type }) => {
   });
 };
 
-// src/client/components/Review/ReviewActions.tsx
+// src/client/components/Review/BulkActions.tsx
 import { Button as Button3, toast as toast2, useConfig as useConfig3 } from "@payloadcms/ui";
 import { useState as useState2 } from "react";
 import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 
-var ReviewActions = ({ entity, locale, reviewed }) => {
+var BulkActions = ({ tab, locales, progress }) => {
   const { config: { routes: { api }, serverURL } } = useConfig3();
+  const [locale, setLocale] = useState2("");
   const [pending, setPending] = useState2(null);
+  const post = async (path, body) => {
+    const res = await fetch(`${serverURL ?? ""}${api}/translator/review/${path}`, {
+      method: "POST",
+      credentials: "include",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    const result = await res.json().catch(() => ({}));
+    if (!res.ok || !result.success)
+      throw new Error(result?.errors?.[0]?.message ?? "request failed");
+    return result;
+  };
+  const queue = async () => {
+    const scope = `${locale ? locale.toUpperCase() : "every locale"} of all ${tab}`;
+    if (!window.confirm(`Queue translation of empty and untranslated fields in ${scope}? Existing translations are kept.`))
+      return;
+    setPending("bulk");
+    try {
+      const { queuedDocuments, queuedLocales, skippedPending } = await post("bulk", { tab, locale, mode: "untranslated" });
+      toast2.success(queuedDocuments ? `Queued ${queuedDocuments} documents (${queuedLocales} locales)${skippedPending ? `, ${skippedPending} already queued` : ""}` : skippedPending ? "Everything incomplete is already queued" : "Nothing to translate");
+      window.location.reload();
+    } catch (error) {
+      toast2.error(`Could not queue: ${error instanceof Error ? error.message : String(error)}`);
+    } finally {
+      setPending(null);
+    }
+  };
+  const runNow = async () => {
+    setPending("run");
+    try {
+      await post("run-jobs", {});
+      toast2.success("Ran a batch of queued translations");
+      window.location.reload();
+    } catch (error) {
+      toast2.error(`Could not run jobs: ${error instanceof Error ? error.message : String(error)}`);
+    } finally {
+      setPending(null);
+    }
+  };
+  return /* @__PURE__ */ jsxs5("div", {
+    className: "tr__bulk",
+    children: [
+      /* @__PURE__ */ jsxs5("div", {
+        className: "tr__bulk-main",
+        children: [
+          /* @__PURE__ */ jsxs5("select", {
+            "aria-label": "Locale",
+            className: "tr__select",
+            onChange: (event) => setLocale(event.target.value),
+            value: locale,
+            children: [
+              /* @__PURE__ */ jsx7("option", {
+                value: "",
+                children: "All locales"
+              }),
+              locales.map((each) => /* @__PURE__ */ jsx7("option", {
+                value: each,
+                children: each.toUpperCase()
+              }, each))
+            ]
+          }),
+          /* @__PURE__ */ jsx7(Button3, {
+            buttonStyle: "primary",
+            disabled: Boolean(pending),
+            onClick: queue,
+            size: "small",
+            children: pending === "bulk" ? "Queuing…" : "Translate untranslated"
+          })
+        ]
+      }),
+      progress && (progress.pending > 0 || progress.failed > 0) && /* @__PURE__ */ jsxs5("div", {
+        className: "tr__bulk-progress",
+        children: [
+          progress.pending > 0 && /* @__PURE__ */ jsxs5("span", {
+            className: "tr__pill",
+            "data-tone": "warn",
+            children: [
+              progress.pending,
+              " queued",
+              progress.running ? `, ${progress.running} running` : ""
+            ]
+          }),
+          progress.failed > 0 && /* @__PURE__ */ jsxs5("span", {
+            className: "tr__pill",
+            "data-tone": "bad",
+            children: [
+              progress.failed,
+              " failed today"
+            ]
+          }),
+          progress.pending > 0 && /* @__PURE__ */ jsx7(Button3, {
+            buttonStyle: "secondary",
+            disabled: Boolean(pending),
+            onClick: runNow,
+            size: "small",
+            children: pending === "run" ? "Running…" : "Run a batch now"
+          })
+        ]
+      })
+    ]
+  });
+};
+// src/client/components/Review/ReviewActions.tsx
+import { Button as Button4, toast as toast3, useConfig as useConfig4 } from "@payloadcms/ui";
+import { useState as useState3 } from "react";
+import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
+
+var ReviewActions = ({ entity, locale, reviewed }) => {
+  const { config: { routes: { api }, serverURL } } = useConfig4();
+  const [pending, setPending] = useState3(null);
   const run = async (action) => {
     if (action === "translate-all" && !window.confirm(`Re-translate every field in ${locale}? Existing ${locale} copy is replaced.`))
       return;
@@ -333,37 +444,37 @@ var ReviewActions = ({ entity, locale, reviewed }) => {
         method: "POST",
         credentials: "include",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ entity, locale, mode: action === "translate-all" ? "all" : "missing" })
+        body: JSON.stringify({ entity, locale, mode: action === "translate-all" ? "all" : "untranslated" })
       });
       const result = await res.json().catch(() => ({}));
       if (!res.ok || !result.success)
         throw new Error(result?.errors?.[0]?.message ?? "request failed");
-      toast2.success(action === "mark-reviewed" ? `${locale} marked as reviewed` : `${locale} translated`);
+      toast3.success(action === "mark-reviewed" ? `${locale} marked as reviewed` : `${locale} translated`);
       window.location.reload();
     } catch (error) {
-      toast2.error(`Could not ${action.replace("-", " ")}: ${error instanceof Error ? error.message : String(error)}`);
+      toast3.error(`Could not ${action.replace("-", " ")}: ${error instanceof Error ? error.message : String(error)}`);
     } finally {
       setPending(null);
     }
   };
-  return /* @__PURE__ */ jsxs5("div", {
+  return /* @__PURE__ */ jsxs6("div", {
     className: "translator-review__actions",
     children: [
-      /* @__PURE__ */ jsx7(Button3, {
+      /* @__PURE__ */ jsx8(Button4, {
         buttonStyle: "primary",
         disabled: Boolean(pending),
-        onClick: () => run("translate-missing"),
+        onClick: () => run("translate-untranslated"),
         size: "small",
-        children: pending === "translate-missing" ? "Translating…" : "Translate missing fields"
+        children: pending === "translate-untranslated" ? "Translating…" : "Translate untranslated fields"
       }),
-      /* @__PURE__ */ jsx7(Button3, {
+      /* @__PURE__ */ jsx8(Button4, {
         buttonStyle: "secondary",
         disabled: Boolean(pending),
         onClick: () => run("translate-all"),
         size: "small",
         children: pending === "translate-all" ? "Translating…" : "Re-translate all"
       }),
-      /* @__PURE__ */ jsx7(Button3, {
+      /* @__PURE__ */ jsx8(Button4, {
         buttonStyle: "secondary",
         disabled: Boolean(pending) || reviewed,
         onClick: () => run("mark-reviewed"),
@@ -374,18 +485,18 @@ var ReviewActions = ({ entity, locale, reviewed }) => {
   });
 };
 // src/client/components/Review/TranslationsNavLink.tsx
-import { useConfig as useConfig4 } from "@payloadcms/ui";
+import { useConfig as useConfig5 } from "@payloadcms/ui";
 import { formatAdminURL } from "payload/shared";
-import { jsx as jsx8 } from "react/jsx-runtime";
+import { jsx as jsx9 } from "react/jsx-runtime";
 
 var TranslationsNavLink = () => {
-  const { config: { routes: { admin } } } = useConfig4();
+  const { config: { routes: { admin } } } = useConfig5();
   const href = formatAdminURL({ adminRoute: admin, path: REVIEW_VIEW_PATH });
-  return /* @__PURE__ */ jsx8("a", {
+  return /* @__PURE__ */ jsx9("a", {
     className: "nav__link",
     href,
     id: "nav-translations",
-    children: /* @__PURE__ */ jsx8("span", {
+    children: /* @__PURE__ */ jsx9("span", {
       className: "nav__link-label",
       children: "Translations"
     })
@@ -395,6 +506,7 @@ var TranslationsNavLink = () => {
 // src/exports/client.ts
 var client_default = CustomButtonWithTranslator;
 export {
+  BulkActions,
   CustomButtonWithTranslator,
   ReviewActions,
   TranslationsNavLink,

package/dist/index.d.ts

@@ -6,6 +6,8 @@ type TranslateArgs = {
 	data?: Record<string, any>;
 	emptyOnly?: boolean;
 	globalSlug?: string;
+	/** with `emptyOnly`, also replace fields that still hold the source copy */
+	retranslateIdentical?: boolean;
 	id?: number | string;
 	locale: string;
 	localeFrom: string;
@@ -18,6 +20,8 @@ type TranslateResult = {
 } | {
 	success: true;
 	translatedData: Record<string, any>;
+	/** values sent to the resolver; 0 means the target needed nothing */
+	translatedCount: number;
 	dataFrom: Doc;
 };
 type TranslateOperationArgs = ({
@@ -45,6 +49,11 @@ type TranslateResolver = {
 	key: string;
 	resolve: (args: TranslateResolverArgs) => Promise<TranslateResolverResponse> | TranslateResolverResponse;
 };
+/**
+* `missing` fills empty fields, `untranslated` also replaces fields that still hold the
+* source copy, `all` re-translates everything.
+*/
+type TranslateMode = "all" | "missing" | "untranslated";
 type TranslatorConfig = {
 	collections: CollectionSlug[];
 	disabled?: boolean;
@@ -56,7 +65,7 @@ type TranslatorConfig = {
 	* `missing` (default) fills empty fields and keeps existing translations and slugs;
 	* `all` re-translates every field.
 	*/
-	autoTranslateMode?: "all" | "missing";
+	autoTranslateMode?: TranslateMode;
 	/** adds the /admin/translations review view, its endpoints and the status collection (default true) */
 	review?: boolean;
 	_options?: {

package/dist/index.js

@@ -4,14 +4,19 @@ import {
   createAutoTranslateCollectionHook2,
   createAutoTranslateGlobalHook2,
   recordTranslationStatus,
+  translateModeArgs,
+  isTranslateMode,
   createTranslateTask2,
   createTranslateWorkflow2
-} from "./shared/chunk-p03jz82h.js";
-import"./shared/chunk-9d433kmv.js";
+} from "./shared/chunk-hkx0bzb6.js";
+import"./shared/chunk-d0n3f8ad.js";
 import {
   readLocales,
-  parseEntityKey
-} from "./shared/chunk-15n5q7wd.js";
+  parseEntityKey,
+  hasTranslateWorkflow,
+  queueBulkTranslation,
+  runQueuedTranslations
+} from "./shared/chunk-4ftfmxgs.js";
 import {
   TRANSLATION_STATUS_SLUG2,
   REVIEW_VIEW_PATH
@@ -171,7 +176,7 @@ var translateHandler = async (req) => {
     collectionSlug,
     globalSlug,
     id,
-    emptyOnly: mode !== "all",
+    ...translateModeArgs(isTranslateMode(mode) ? mode : "untranslated"),
     locale,
     localeFrom: defaultLocale,
     overrideAccess: false,
@@ -208,7 +213,39 @@ var markReviewedHandler = async (req) => {
   });
   return Response.json({ success: true });
 };
+var bulkHandler = async (req) => {
+  if (!req.user)
+    throw new APIError("Unauthorized", 401);
+  if (!req.json)
+    throw new APIError("Content-Type should be json");
+  if (!hasTranslateWorkflow(req))
+    throw new APIError("Bulk translation needs autoTranslate enabled, which registers the translate jobs", 400);
+  const body = await req.json();
+  const pluginConfig = req.payload.config.custom?.translator;
+  const { targetLocales } = readLocales(req);
+  const tabAllowed = body.tab === "globals" ? Boolean(pluginConfig?.globals.length) : pluginConfig?.collections.includes(body.tab);
+  if (!body.tab || !tabAllowed)
+    throw new APIError("Forbidden", 403);
+  if (body.locale && !targetLocales.includes(body.locale))
+    throw new APIError("Bad Request", 400);
+  const result = await queueBulkTranslation({
+    req,
+    tab: body.tab,
+    locale: body.locale || undefined,
+    mode: isTranslateMode(body.mode) ? body.mode : "untranslated"
+  });
+  return Response.json({ success: true, ...result });
+};
+var runJobsHandler = async (req) => {
+  if (!req.user)
+    throw new APIError("Unauthorized", 401);
+  if (!hasTranslateWorkflow(req))
+    throw new APIError("Translate jobs are not registered", 400);
+  return Response.json({ success: true, progress: await runQueuedTranslations(req) });
+};
 var reviewEndpoints = [
+  { path: "/translator/review/bulk", method: "post", handler: bulkHandler },
+  { path: "/translator/review/run-jobs", method: "post", handler: runJobsHandler },
   { path: "/translator/review/translate", method: "post", handler: translateHandler },
   { path: "/translator/review/mark-reviewed", method: "post", handler: markReviewedHandler }
 ];

package/dist/jobs.js

@@ -1,12 +1,13 @@
 import {
-  TRANSLATE_TASK_SLUG2,
-  TRANSLATE_WORKFLOW_SLUG2,
   createAutoTranslateCollectionHook2,
   createAutoTranslateGlobalHook2,
   createTranslateTask2,
   createTranslateWorkflow2
-} from "./shared/chunk-p03jz82h.js";
-import"./shared/chunk-9d433kmv.js";
+} from "./shared/chunk-hkx0bzb6.js";
+import {
+  TRANSLATE_TASK_SLUG2,
+  TRANSLATE_WORKFLOW_SLUG2
+} from "./shared/chunk-d0n3f8ad.js";
 
 // src/exports/jobs.ts
 var jobs = {

package/dist/rsc.js

@@ -1,10 +1,11 @@
-import"./shared/chunk-9d433kmv.js";
+import"./shared/chunk-d0n3f8ad.js";
 import {
   readLocales,
   loadCollectionReview,
   loadGlobalsReview,
-  loadEntityLocaleReview
-} from "./shared/chunk-15n5q7wd.js";
+  loadEntityLocaleReview,
+  loadJobsProgress
+} from "./shared/chunk-4ftfmxgs.js";
 import {
   REVIEW_VIEW_PATH
 } from "./shared/chunk-31qgv1zk.js";
@@ -12,6 +13,7 @@ import {
 // src/review/view/TranslationsView.tsx
 import { DefaultTemplate } from "@payloadcms/next/templates";
 import { Gutter } from "@payloadcms/ui";
+import { BulkActions } from "@justanarthur/payload-plugin-translator/client";
 
 // src/review/view/Detail.tsx
 import { ReviewActions } from "@justanarthur/payload-plugin-translator/client";
@@ -456,6 +458,10 @@ var reviewStyles = `
 .tr__toggle::before { content: ''; width: 26px; height: 14px; border-radius: 999px; background: var(--theme-elevation-200) radial-gradient(circle at 7px 50%, var(--theme-elevation-0) 4px, transparent 4.5px); }
 .tr__toggle[aria-pressed='true']::before { background: var(--tr-ok) radial-gradient(circle at 19px 50%, var(--theme-elevation-0) 4px, transparent 4.5px); }
 
+.tr__bulk { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 10px; margin-bottom: calc(var(--base) * 1.25); padding: 10px 12px; border: 1px dashed var(--tr-line); border-radius: var(--style-radius-m); }
+.tr__bulk-main, .tr__bulk-progress { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
+.tr__bulk .btn { margin: 0; }
+.tr__select { height: 28px; padding: 0 8px; border: 1px solid var(--tr-line); border-radius: var(--style-radius-s, 4px); background: var(--theme-input-bg, var(--theme-elevation-0)); color: var(--theme-text); font: inherit; font-size: 13px; }
 .tr__card { border: 1px solid var(--tr-line); border-radius: var(--style-radius-m); overflow: auto; background: var(--theme-elevation-0); }
 .tr table { width: 100%; border-collapse: separate; border-spacing: 0; font-size: 13px; }
 .tr th { position: sticky; top: 0; z-index: 1; background: var(--tr-card); text-align: left; font-weight: 500; color: var(--tr-muted); padding: 10px 12px; border-bottom: 1px solid var(--tr-line); white-space: nowrap; }
@@ -628,6 +634,7 @@ var TranslationsView = async ({ initPageResult, params, searchParams }) => {
     });
   };
   const adminLocale = req.locale;
+  const progress = entity || !req.user ? null : await loadJobsProgress(req);
   const body = await content();
   req.locale = adminLocale;
   return /* @__PURE__ */ jsxs3(DefaultTemplate, {
@@ -685,6 +692,11 @@ var TranslationsView = async ({ initPageResult, params, searchParams }) => {
                     children: "Only incomplete"
                   })
                 ]
+              }),
+              req.user && tab && /* @__PURE__ */ jsx3(BulkActions, {
+                locales: targetLocales,
+                progress,
+                tab
               })
             ]
           }),

package/dist/shared/{chunk-15n5q7wd.js → chunk-4ftfmxgs.js}

@@ -1,33 +1,16 @@
 import {
   samePlaceholders,
-  isOpaqueText,
+  plainText,
+  looksUntranslated,
+  TRANSLATE_WORKFLOW_SLUG2,
   collectTranslatableFields,
   entityKey,
   sourceHash
-} from "./chunk-9d433kmv.js";
+} from "./chunk-d0n3f8ad.js";
 import {
   TRANSLATION_STATUS_SLUG2
 } from "./chunk-31qgv1zk.js";
 
-// src/review/plainText.ts
-var plainText = (value) => {
-  if (typeof value === "string")
-    return value;
-  if (!value || typeof value !== "object")
-    return "";
-  if (Array.isArray(value))
-    return value.map(plainText).filter(Boolean).join(" ");
-  const node = value;
-  if (typeof node.text === "string")
-    return node.text;
-  if ("root" in node)
-    return plainText(node.root);
-  if (Array.isArray(node.children))
-    return node.children.map(plainText).filter(Boolean).join(node.type === "root" ? `
-` : "");
-  return "";
-};
-
 // src/review/computeStatus.ts
 var normalize = (text) => text.replace(/\s+/g, " ").trim();
 var classify = (field, sourceText, targetText) => {
@@ -35,8 +18,7 @@ var classify = (field, sourceText, targetText) => {
     return "missing";
   if (field.type === "json" && !samePlaceholders(sourceText, targetText))
     return "placeholders";
-  const same = normalize(sourceText) === normalize(targetText);
-  if (same && field.type !== "slug" && normalize(sourceText).length > 3 && !isOpaqueText(sourceText) && /\s/.test(normalize(sourceText)))
+  if (field.type !== "slug" && looksUntranslated(sourceText, targetText))
     return "identical";
   return "ok";
 };
@@ -250,4 +232,108 @@ var loadLastJob = async (req, { collectionSlug, globalSlug, id }, locale) => {
   }
 };
 
-export { readLocales, loadCollectionReview, loadGlobalsReview, parseEntityKey, loadEntityLocaleReview };
+// src/review/bulk.ts
+var JOBS_SLUG = "payload-jobs";
+var pendingWhere = {
+  and: [
+    { workflowSlug: { equals: TRANSLATE_WORKFLOW_SLUG2 } },
+    { completedAt: { exists: false } },
+    { hasError: { not_equals: true } }
+  ]
+};
+var hasTranslateWorkflow = (req) => Boolean(req.payload.config.jobs?.workflows?.some((workflow) => workflow.slug === TRANSLATE_WORKFLOW_SLUG2)) && Boolean(req.payload.collections[JOBS_SLUG]);
+var loadJobsProgress = async (req) => {
+  if (!hasTranslateWorkflow(req))
+    return null;
+  const count = (where) => req.payload.count({ collection: JOBS_SLUG, where, overrideAccess: true, req }).then(({ totalDocs }) => totalDocs);
+  const dayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+  const [pending, running, failed] = await Promise.all([
+    count(pendingWhere),
+    count({ and: [...pendingWhere.and ?? [], { processing: { equals: true } }] }),
+    count({ and: [{ workflowSlug: { equals: TRANSLATE_WORKFLOW_SLUG2 } }, { hasError: { equals: true } }, { updatedAt: { greater_than: dayAgo } }] })
+  ]);
+  return { pending, running, failed };
+};
+var loadPendingPairs = async (req) => {
+  const { docs } = await req.payload.find({
+    collection: JOBS_SLUG,
+    where: pendingWhere,
+    pagination: false,
+    depth: 0,
+    overrideAccess: true,
+    req
+  });
+  const pairs = new Set;
+  for (const { input } of docs) {
+    if (!input)
+      continue;
+    const key = entityKey({ collectionSlug: input.collection, globalSlug: input.global, id: input.id });
+    for (const locale of input.toLocales ?? (input.toLocale ? [input.toLocale] : []))
+      pairs.add(`${key}|${locale}`);
+  }
+  return pairs;
+};
+var incompleteLocales = (entity, locales) => locales.filter((locale) => {
+  const review = entity.locales[locale];
+  return review && (review.summary.coverage < 100 || review.summary.slugMissing);
+});
+var queueBulkTranslation = async ({ req, tab, locale, mode }) => {
+  const pluginConfig = req.payload.config.custom?.translator;
+  const { defaultLocale, targetLocales } = readLocales(req);
+  const locales = locale ? [locale] : targetLocales;
+  const resolver = pluginConfig.resolvers[0]?.key;
+  const pending = await loadPendingPairs(req);
+  let queuedDocuments = 0;
+  let queuedLocales = 0;
+  let skippedPending = 0;
+  const queue = async (entity) => {
+    const toLocales = incompleteLocales(entity, locales).filter((each) => {
+      const already = pending.has(`${entity.key}|${each}`);
+      if (already)
+        skippedPending++;
+      return !already;
+    });
+    if (!toLocales.length)
+      return;
+    await req.payload.jobs.queue({
+      req,
+      workflow: TRANSLATE_WORKFLOW_SLUG2,
+      input: {
+        id: entity.id,
+        collection: entity.collectionSlug,
+        global: entity.globalSlug,
+        updatedAt: new Date().toISOString(),
+        fromLocale: defaultLocale,
+        toLocales,
+        resolver,
+        mode
+      }
+    });
+    queuedDocuments++;
+    queuedLocales += toLocales.length;
+  };
+  if (tab === "globals") {
+    const { entities } = await loadGlobalsReview({ req, globalSlugs: pluginConfig.globals });
+    for (const entity of entities)
+      await queue(entity);
+  } else {
+    for (let page = 1;; page++) {
+      const review = await loadCollectionReview({ req, collectionSlug: tab, page, limit: 50 });
+      for (const entity of review.entities)
+        await queue(entity);
+      if (page >= review.totalPages)
+        break;
+    }
+  }
+  return { queuedDocuments, queuedLocales, skippedPending };
+};
+var runQueuedTranslations = async (req, limit = 3) => {
+  await req.payload.jobs.run({
+    limit,
+    where: { workflowSlug: { equals: TRANSLATE_WORKFLOW_SLUG2 } },
+    req
+  });
+  return loadJobsProgress(req);
+};
+
+export { readLocales, loadCollectionReview, loadGlobalsReview, parseEntityKey, loadEntityLocaleReview, hasTranslateWorkflow, loadJobsProgress, queueBulkTranslation, runQueuedTranslations };

package/dist/shared/{chunk-9d433kmv.js → chunk-d0n3f8ad.js}

@@ -1,3 +1,7 @@
+// src/jobs/constants.ts
+var TRANSLATE_TASK_SLUG2 = "translateEntityToLocale";
+var TRANSLATE_WORKFLOW_SLUG2 = "translateEntityToLocales";
+
 // src/utils/placeholders.ts
 var placeholdersOf = (value) => (value.match(/\{\s*[\w.]+\s*(?:,[^{}]*)?\}/g) ?? []).map((each) => each.replace(/\s+/g, "")).sort();
 var samePlaceholders = (source, translated) => placeholdersOf(source).join("|") === placeholdersOf(translated).join("|");
@@ -46,6 +50,32 @@ var isOpaqueText = (value) => {
   return /^([a-z][a-z0-9+.-]*:|\/\/|\/|#|www\.)/i.test(text) || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(text) || !/\p{L}/u.test(text);
 };
 
+// src/utils/plainText.ts
+var plainText = (value) => {
+  if (typeof value === "string")
+    return value;
+  if (!value || typeof value !== "object")
+    return "";
+  if (Array.isArray(value))
+    return value.map(plainText).filter(Boolean).join(" ");
+  const node = value;
+  if (typeof node.text === "string")
+    return node.text;
+  if ("root" in node)
+    return plainText(node.root);
+  if (Array.isArray(node.children))
+    return node.children.map(plainText).filter(Boolean).join(node.type === "root" ? `
+` : "");
+  return "";
+};
+
+// src/utils/looksUntranslated.ts
+var normalize = (text) => text.replace(/\s+/g, " ").trim();
+var looksUntranslated = (source, target) => {
+  const sourceText = normalize(plainText(source));
+  return sourceText.length > 3 && /\s/.test(sourceText) && !isOpaqueText(sourceText) && sourceText === normalize(plainText(target));
+};
+
 // src/utils/sanitizeSlug.ts
 var sanitizeSlug = (text) => text.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9-_]+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
 
@@ -95,6 +125,7 @@ var traverseFields = (args) => {
   const {
     dataFrom,
     emptyOnly,
+    retranslateIdentical,
     fields,
     localizedParent,
     path,
@@ -106,6 +137,7 @@ var traverseFields = (args) => {
   const { additionalTraverseRichText } = _options ?? {};
   const siblingDataFrom = args.siblingDataFrom ?? dataFrom;
   const siblingDataTranslated = args.siblingDataTranslated ?? translatedData;
+  const keepsTarget = (source, target) => Boolean(emptyOnly) && hasText(target) && !(retranslateIdentical && looksUntranslated(source, target));
   const recurse = (overrides) => traverseFields({ ...args, siblingDataFrom, siblingDataTranslated, ...overrides });
   for (const field of fields) {
     switch (field.type) {
@@ -226,7 +258,7 @@ var traverseFields = (args) => {
               onField?.({ path: keyPath, type: "json", source: value, target: previous });
               if (!value.trim())
                 continue;
-              if (emptyOnly && typeof previous === "string" && previous.trim())
+              if (keepsTarget(value, previous))
                 continue;
               target[key] = value;
               if (isOpaqueText(value))
@@ -266,7 +298,7 @@ var traverseFields = (args) => {
         if (typeof value !== "string" || !value.trim())
           break;
         const hasCurrent = typeof current === "string" && current.trim().length > 0;
-        if (hasCurrent && (emptyOnly || isSlug))
+        if (isSlug ? hasCurrent : keepsTarget(value, current))
           break;
         if (isOpaqueText(value)) {
           siblingDataTranslated[field.name] = value;
@@ -304,7 +336,7 @@ var traverseFields = (args) => {
         onField?.({ path: richTextPath, type: "richText", source: richTextDataFrom, target: current });
         if (!richTextDataFrom || !hasText(richTextDataFrom))
           break;
-        if (emptyOnly && hasText(current))
+        if (keepsTarget(richTextDataFrom, current))
           break;
         const isSlate = Array.isArray(richTextDataFrom);
         const isLexical = typeof richTextDataFrom === "object" && "root" in richTextDataFrom;
@@ -356,4 +388,4 @@ var entityKey = ({ collectionSlug, globalSlug, id }) => globalSlug ? `global:${g
 import { createHash } from "node:crypto";
 var sourceHash = (fields) => createHash("sha1").update(JSON.stringify(fields.map(({ path, source }) => [path, source]))).digest("hex");
 
-export { samePlaceholders, isOpaqueText, traverseFields, collectTranslatableFields, entityKey, sourceHash };
+export { samePlaceholders, plainText, looksUntranslated, traverseFields, TRANSLATE_TASK_SLUG2, TRANSLATE_WORKFLOW_SLUG2, collectTranslatableFields, entityKey, sourceHash };

package/dist/shared/{chunk-p03jz82h.js → chunk-hkx0bzb6.js}

@@ -1,10 +1,11 @@
 import {
   samePlaceholders,
   traverseFields,
+  TRANSLATE_WORKFLOW_SLUG2,
   collectTranslatableFields,
   entityKey,
   sourceHash
-} from "./chunk-9d433kmv.js";
+} from "./chunk-d0n3f8ad.js";
 import {
   TRANSLATION_STATUS_SLUG2
 } from "./chunk-31qgv1zk.js";
@@ -127,6 +128,7 @@ var translateOperation2 = async (args) => {
   traverseFields({
     dataFrom,
     emptyOnly: args.emptyOnly,
+    retranslateIdentical: args.retranslateIdentical,
     fields: config.fields,
     translatedData,
     valuesToTranslate,
@@ -178,7 +180,7 @@ ${valuesToTranslate.map((v) => `  ${v.path ?? "(unknown)"}: ${preview(v.value)}`
 ${summary.join(`
 `)}` : "")
     });
-    if (args.update) {
+    if (args.update && valuesToTranslate.length > 0) {
       const { _locale, _parent_id, createdAt, updatedAt, ...data } = translatedData;
       await updateEntity({
         collectionSlug,
@@ -194,16 +196,13 @@ ${summary.join(`
     result = {
       success: true,
       translatedData,
+      translatedCount: valuesToTranslate.length,
       dataFrom
     };
   }
   return result;
 };
 
-// src/jobs/constants.ts
-var TRANSLATE_TASK_SLUG2 = "translateEntityToLocale";
-var TRANSLATE_WORKFLOW_SLUG2 = "translateEntityToLocales";
-
 // src/jobs/createAutoTranslateCollectionHook.ts
 function createAutoTranslateCollectionHook2(options) {
   const {
@@ -432,6 +431,13 @@ var recordTranslationStatus = async ({ req, collectionSlug, globalSlug, id, loca
   await upsertTranslationStatus(req, entityKey({ collectionSlug, globalSlug, id }), locale, reviewedBy ? { reviewedHash: hash, reviewedAt: now, reviewedBy } : { sourceHash: hash, translatedAt: now });
 };
 
+// src/utils/translateMode.ts
+var translateModeArgs = (mode) => ({
+  emptyOnly: mode !== "all",
+  retranslateIdentical: mode === "untranslated"
+});
+var isTranslateMode = (value) => value === "all" || value === "missing" || value === "untranslated";
+
 // src/jobs/createTranslateTask.ts
 function createTranslateTask2(options = {}) {
   const { slug = "translateEntityToLocale" } = options;
@@ -451,7 +457,7 @@ function createTranslateTask2(options = {}) {
     handler: async (args) => {
       const { input, job, req } = args;
       const { id, collection, global, fromLocale, toLocale, resolver: inputResolver } = input;
-      const mode = input.mode ?? readAutoTranslateMode(req);
+      const mode = isTranslateMode(input.mode) ? input.mode : readAutoTranslateMode(req);
       if (!collection && !global) {
         throw new Error("translateTask: either `collection` or `global` must be provided");
       }
@@ -470,7 +476,7 @@ function createTranslateTask2(options = {}) {
           req,
           collectionSlug: collection,
           globalSlug: global,
-          emptyOnly: mode !== "all",
+          ...translateModeArgs(mode),
           id,
           locale: toLocale,
           localeFrom: fromLocale,
@@ -507,6 +513,10 @@ function createTranslateTask2(options = {}) {
         });
         return { output: { success: true } };
       }
+      if (result.translatedCount === 0) {
+        req.payload.logger.info({ jobId: job.id, msg: `[translate] ${entityLabel}#${id ?? global} → ${toLocale}: nothing to translate` });
+        return { output: { success: true } };
+      }
       const translated = result.translatedData ?? {};
       const { _locale: _dropLocale, _parent_id: _dropParent, updatedAt: _dropUpdatedAt, createdAt: _dropCreatedAt, ...data } = translated;
       req.payload.logger.info({
@@ -558,7 +568,8 @@ function readFirstResolverKey3(req) {
   return typeof first?.key === "string" ? first.key : "";
 }
 function readAutoTranslateMode(req) {
-  return req.payload.config.custom?.translator?.autoTranslateMode === "all" ? "all" : "missing";
+  const mode = req.payload.config.custom?.translator?.autoTranslateMode;
+  return isTranslateMode(mode) ? mode : "missing";
 }
 
 // src/jobs/createTranslateWorkflow.ts
@@ -574,11 +585,12 @@ function createTranslateWorkflow2(options = {}) {
       { name: "fromLocale", type: "text", required: true },
       { name: "toLocales", type: "json", required: false },
       { name: "toLocale", type: "text", required: false },
-      { name: "resolver", type: "text", required: false }
+      { name: "resolver", type: "text", required: false },
+      { name: "mode", type: "text", required: false }
     ],
     handler: async (args) => {
       const { job, req, tasks } = args;
-      const { id, collection, global, fromLocale, toLocales, toLocale, updatedAt, resolver } = job.input;
+      const { id, collection, global, fromLocale, toLocales, toLocale, updatedAt, resolver, mode } = job.input;
       if (!collection && !global) {
         throw new Error("translateWorkflow: either `collection` or `global` must be provided");
       }
@@ -612,7 +624,8 @@ function createTranslateWorkflow2(options = {}) {
             global,
             fromLocale,
             toLocale: target,
-            resolver
+            resolver,
+            mode
           }
         });
       }
@@ -620,4 +633,4 @@ function createTranslateWorkflow2(options = {}) {
   };
 }
 
-export { findEntityWithConfig, translateOperation2, TRANSLATE_TASK_SLUG2, TRANSLATE_WORKFLOW_SLUG2, createAutoTranslateCollectionHook2, createAutoTranslateGlobalHook2, recordTranslationStatus, createTranslateTask2, createTranslateWorkflow2 };
+export { findEntityWithConfig, translateOperation2, createAutoTranslateCollectionHook2, createAutoTranslateGlobalHook2, recordTranslationStatus, translateModeArgs, isTranslateMode, createTranslateTask2, createTranslateWorkflow2 };

package/dist/types.d.ts

@@ -16,6 +16,11 @@ type TranslateResolver = {
 	key: string;
 	resolve: (args: TranslateResolverArgs) => Promise<TranslateResolverResponse> | TranslateResolverResponse;
 };
+/**
+* `missing` fills empty fields, `untranslated` also replaces fields that still hold the
+* source copy, `all` re-translates everything.
+*/
+type TranslateMode = "all" | "missing" | "untranslated";
 type TranslatorConfig = {
 	collections: CollectionSlug[];
 	disabled?: boolean;
@@ -27,7 +32,7 @@ type TranslatorConfig = {
 	* `missing` (default) fills empty fields and keeps existing translations and slugs;
 	* `all` re-translates every field.
 	*/
-	autoTranslateMode?: "all" | "missing";
+	autoTranslateMode?: TranslateMode;
 	/** adds the /admin/translations review view, its endpoints and the status collection (default true) */
 	review?: boolean;
 	_options?: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@justanarthur/payload-plugin-translator",
   "description": "Translator plugin for Payload CMS — automatic localization via Google, OpenAI, LibreTranslate, or custom resolvers.",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "type": "module",
   "private": false,
   "files": [