@smartcat/sanity-plugin 1.2.0 → 1.3.0

package/dist/index.cjs

@@ -88,7 +88,19 @@ function createTranslationProjectType() {
               // Set when the item was added from the published perspective, so the
               // export translates the published document. Absent/false (incl. all
               // legacy items) prefers the draft — see itemDocDerefRespectingDraft.
-              sanity.defineField({ name: "sourceIsPublished", title: "Source is published", type: "boolean" })
+              sanity.defineField({ name: "sourceIsPublished", title: "Source is published", type: "boolean" }),
+              // When true, the export sends the item's *existing* translations to
+              // Smartcat: one bilingual LocJSON per target language (populated from
+              // field/linked-doc translations), grouped via `{name}_{lang}.locjson`.
+              // Absent/false (incl. all legacy items) ⇒ today's behaviour: a single
+              // source-only file targeting all languages. Note: imported bilingual
+              // targets land confirmed at every workflow stage (Smartcat ignores
+              // per-segment status on LocJSON import), i.e. they skip human review.
+              sanity.defineField({
+                name: "sendExistingTranslations",
+                title: "Send existing translations",
+                type: "boolean"
+              })
             ],
             preview: { select: { title: "docId", subtitle: "docType" } }
           })
@@ -198,8 +210,15 @@ function createTranslationProjectType() {
             type: "object",
             name: "smartcatOutboxItem",
             fields: [
+              sanity.defineField({ name: "sourceDocId", type: "string" }),
+              sanity.defineField({ name: "title", type: "string" }),
               sanity.defineField({ name: "filename", type: "string" }),
-              sanity.defineField({ name: "locjson", type: "text" })
+              sanity.defineField({ name: "locjson", type: "text" }),
+              // Present only for per-language bilingual files (send-existing flow):
+              // the single target language this file carries, so the export Function
+              // uploads it with `documentModel targetLanguages:[lang]`. Absent ⇒
+              // upload targeting all project languages (the source-only default).
+              sanity.defineField({ name: "targetLanguage", type: "string" })
             ]
           })
         ]
@@ -434,7 +453,7 @@ const PROJECTS_QUERY$1 = `*[_type == $type] | order(name asc){
 function createAddToProjectAction(config) {
   const sourceLanguage = config.sourceLanguage;
   return (props) => {
-    const { id, draft, published, onComplete } = props, client = sanity.useClient({ apiVersion: constants.API_VERSION }), schema = sanity.useSchema(), toast = ui.useToast(), { selectedPerspectiveName } = sanity.usePerspective(), sourceIsPublished = selectedPerspectiveName === "published" || !draft, [open, setOpen] = react.useState(!1), [projects, setProjects] = react.useState(null), [selection, setSelection] = react.useState(CREATE_NEW), [newName, setNewName] = react.useState(""), [busy, setBusy] = react.useState(!1), [includeLinked, setIncludeLinked] = react.useState(!0), { templates, loaded, requestRefresh } = useTemplates(), [workflow2, setWorkflow] = useWorkflowSelection(open, templates, loaded), publishedId2 = id.replace(/^drafts\./, ""), doc = draft ?? published, docTitle = doc && resolveDocumentTitle(schema, doc) || UNTITLED;
+    const { id, draft, published, onComplete } = props, client = sanity.useClient({ apiVersion: constants.API_VERSION }), schema = sanity.useSchema(), toast = ui.useToast(), { selectedPerspectiveName } = sanity.usePerspective(), sourceIsPublished = selectedPerspectiveName === "published" || !draft, [open, setOpen] = react.useState(!1), [projects, setProjects] = react.useState(null), [selection, setSelection] = react.useState(CREATE_NEW), [newName, setNewName] = react.useState(""), [busy, setBusy] = react.useState(!1), [includeLinked, setIncludeLinked] = react.useState(!0), [sendExisting, setSendExisting] = react.useState(!1), { templates, loaded, requestRefresh } = useTemplates(), [workflow2, setWorkflow] = useWorkflowSelection(open, templates, loaded), publishedId2 = id.replace(/^drafts\./, ""), doc = draft ?? published, docTitle = doc && resolveDocumentTitle(schema, doc) || UNTITLED;
     react.useEffect(() => {
       if (!open) return;
       requestRefresh();
@@ -457,7 +476,8 @@ function createAddToProjectAction(config) {
           _key: uuid.uuid(),
           docId,
           docType,
-          sourceIsPublished
+          sourceIsPublished,
+          sendExistingTranslations: sendExisting
         }), collected = /* @__PURE__ */ new Map([[publishedId2, doc?._type]]);
         if (includeLinked) {
           const linked = await gatherLinkedDocuments({ client, rootId: publishedId2, isRoot: (type) => config.rootTypes.includes(type), isTranslatable: (type) => locjson.getTranslatableFields(schema.get(type), { exclude: [config.documentI18nLanguageField] }).length > 0 });
@@ -499,7 +519,7 @@ function createAddToProjectAction(config) {
       } finally {
         setBusy(!1);
       }
-    }, [selection, newName, workflow2, publishedId2, doc, includeLinked, sourceIsPublished, schema, client, projects, close]), content = react.useMemo(() => projects === null ? /* @__PURE__ */ jsxRuntime.jsx(ui.Flex, { align: "center", justify: "center", padding: 4, children: /* @__PURE__ */ jsxRuntime.jsx(ui.Spinner, { muted: !0 }) }) : /* @__PURE__ */ jsxRuntime.jsxs(ui.Stack, { space: 4, children: [
+    }, [selection, newName, workflow2, publishedId2, doc, includeLinked, sendExisting, sourceIsPublished, schema, client, projects, close]), content = react.useMemo(() => projects === null ? /* @__PURE__ */ jsxRuntime.jsx(ui.Flex, { align: "center", justify: "center", padding: 4, children: /* @__PURE__ */ jsxRuntime.jsx(ui.Spinner, { muted: !0 }) }) : /* @__PURE__ */ jsxRuntime.jsxs(ui.Stack, { space: 4, children: [
       /* @__PURE__ */ jsxRuntime.jsxs(ui.Stack, { space: 3, children: [
         /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { size: 1, children: "Project" }),
         /* @__PURE__ */ jsxRuntime.jsxs(
@@ -580,6 +600,20 @@ function createAddToProjectAction(config) {
             /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: 1, weight: "medium", children: "Include linked content" }),
             /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: 1, muted: !0, children: "Also add documents this one references, recursively \u2014 skipping any already in the project." })
           ] })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs(ui.Flex, { align: "flex-start", gap: 3, children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            ui.Switch,
+            {
+              checked: sendExisting,
+              onChange: (e) => setSendExisting(e.currentTarget.checked),
+              disabled: busy
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsxs(ui.Stack, { space: 2, children: [
+            /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: 1, weight: "medium", children: "Send existing translations" }),
+            /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: 1, muted: !0, children: "Upload current translations alongside the source, so Smartcat starts pre-filled. Imported translations are marked confirmed at every stage \u2014 they skip human review." })
+          ] })
         ] })
       ] }) }),
       /* @__PURE__ */ jsxRuntime.jsxs(ui.Flex, { justify: "flex-end", gap: 2, children: [
@@ -596,7 +630,7 @@ function createAddToProjectAction(config) {
           }
         )
       ] })
-    ] }), [projects, selection, newName, workflow2, templates, busy, includeLinked, docTitle, sourceIsPublished, close, handleConfirm]);
+    ] }), [projects, selection, newName, workflow2, templates, busy, includeLinked, sendExisting, docTitle, sourceIsPublished, close, handleConfirm]);
     return {
       label: "Add to translation project",
       icon: icons.TranslateIcon,
@@ -633,6 +667,7 @@ const PROJECTS_QUERY = `*[_type == "${constants.TRANSLATION_PROJECT_TYPE}"] | or
     _key,
     "docId": ${progress.ITEM_ID},
     sourceIsPublished,
+    sendExistingTranslations,
     "doc": ${progress.itemDocDeref("{_id, _type}")},
     "translations": *[_type == "translation.metadata" && references(${progress.ITEM_ID_FROM_SUBQUERY})][0]
       .translations[]{language, "id": value._ref}
@@ -830,8 +865,11 @@ const ITEMS_QUERY = `*[_id == $id][0]{
   items[]{
     "docId": ${progress.ITEM_ID},
     "docType": docType,
+    sendExistingTranslations,
     "doc": ${progress.itemDocDerefRespectingDraft()}
   }
+}`, SIBLINGS_QUERY = `*[_type == "translation.metadata" && references($ids)]{
+  "variants": translations[]{ "language": _key, "doc": value-> }
 }`;
 async function prepareExport({
   client,
@@ -856,7 +894,22 @@ async function prepareExport({
   }
   const deletedDocIds = new Set(deletions.map((d) => d.sourceDocId)), items = (project?.items ?? []).filter(
     (item) => !(item.docId && deletedDocIds.has(item.docId))
-  ), unresolved = items.filter((item) => !item.doc), docs = items.map((item) => item.doc).filter((d) => !!d), fieldsByType = /* @__PURE__ */ new Map(), fieldsFor = (type) => {
+  ), unresolved = items.filter((item) => !item.doc), docs = items.map((item) => item.doc).filter((d) => !!d), siblingsByDocId = /* @__PURE__ */ new Map(), flaggedDocLevelIds = items.filter(
+    (item) => item.doc && item.sendExistingTranslations === !0 && locjson.localizationMode(schema.get(item.doc._type)) === "document"
+  ).map((item) => publishedId(item.doc._id));
+  if (flaggedDocLevelIds.length > 0) {
+    const groups = await client.fetch(
+      SIBLINGS_QUERY,
+      { ids: flaggedDocLevelIds }
+    );
+    for (const group of groups ?? []) {
+      const byLang = /* @__PURE__ */ new Map(), groupSourceIds = [];
+      for (const variant of group.variants ?? [])
+        variant.doc && (byLang.set(variant.language, variant.doc), groupSourceIds.push(publishedId(variant.doc._id)));
+      for (const sid of groupSourceIds) siblingsByDocId.set(sid, byLang);
+    }
+  }
+  const fieldsByType = /* @__PURE__ */ new Map(), fieldsFor = (type) => {
     let fields = fieldsByType.get(type);
     return fields || (fields = locjson.getTranslatableFields(schema.get(type), { exclude }), fieldsByType.set(type, fields)), fields;
   }, configuredLanguages = languages.map((l) => l.id).join(", ") || "(none)", configuredTypes = translatableTypes === void 0 ? "all types" : translatableTypes.join(", ") || "(none)";
@@ -866,12 +919,46 @@ async function prepareExport({
       level: "error",
       message: `${item.docId ?? "unknown document"} (${item.docType ?? "unknown type"}): no document found \u2014 it may be unpublished or deleted; skipped`
     });
-  const outbox = [];
-  for (const rawDoc of docs) {
-    const isDraft = rawDoc._id.startsWith("drafts."), doc = isDraft ? { ...rawDoc, _id: publishedId(rawDoc._id) } : rawDoc, name = resolveDocumentTitle(schema, doc);
-    log({ level: "info", message: `${name || doc._id}  \xB7  ${doc._type}${isDraft ? " (draft)" : ""}` });
+  const outbox = [], queueBilingual = (doc, name, fields, isDraft) => {
+    const mode = locjson.localizationMode(schema.get(doc._type)), byLang = mode === "document" ? siblingsByDocId.get(doc._id) : void 0;
+    let queued = 0;
+    for (const targetSanityId of targetLanguages) {
+      const smartcatCode = progress.toSmartcatLanguage(smartcatLanguages, targetSanityId), target = mode === "field" ? { language: targetSanityId } : { language: targetSanityId, doc: byLang?.get(targetSanityId) }, locjson$1 = locjson.serializeToLocjson(doc, fields, { sourceLanguage: source, fieldLanguageKey, target });
+      if (locjson$1.units.length === 0) {
+        log({ level: "skip", indent: !0, message: `${targetSanityId}: no translatable content \u2014 not sent` });
+        continue;
+      }
+      const prefilled = locjson$1.units.filter((u) => u.target.length > 0).length;
+      outbox.push({
+        _key: uuid.uuid(),
+        sourceDocId: doc._id,
+        title: name,
+        filename: locjson.buildLocjsonFilename(doc._type, doc._id, name, { draft: isDraft, language: smartcatCode }),
+        locjson: JSON.stringify(locjson$1),
+        targetLanguage: smartcatCode
+      }), queued++, log({
+        level: "success",
+        indent: !0,
+        message: `${targetSanityId} \u2192 ${smartcatCode}: queued ${locjson$1.units.length} unit(s), ${prefilled} with existing translation`
+      });
+    }
+    queued === 0 && log({ level: "skip", indent: !0, message: "no translatable content \u2014 not sent" });
+  };
+  for (const item of items) {
+    const rawDoc = item.doc;
+    if (!rawDoc) continue;
+    const isDraft = rawDoc._id.startsWith("drafts."), doc = isDraft ? { ...rawDoc, _id: publishedId(rawDoc._id) } : rawDoc, name = resolveDocumentTitle(schema, doc), sendExisting = item.sendExistingTranslations === !0;
+    log({
+      level: "info",
+      message: `${name || doc._id}  \xB7  ${doc._type}${isDraft ? " (draft)" : ""}${sendExisting ? " \xB7 sending existing translations" : ""}`
+    });
     try {
-      const fields = fieldsFor(doc._type), skippedBlockTypes = /* @__PURE__ */ new Map(), locjson$1 = locjson.serializeToLocjson(doc, fields, {
+      const fields = fieldsFor(doc._type);
+      if (sendExisting) {
+        queueBilingual(doc, name, fields, isDraft);
+        continue;
+      }
+      const skippedBlockTypes = /* @__PURE__ */ new Map(), locjson$1 = locjson.serializeToLocjson(doc, fields, {
         sourceLanguage: source,
         fieldLanguageKey,
         onSkippedField: ({ fieldPath, types }) => skippedBlockTypes.set(fieldPath, types)
@@ -1462,39 +1549,55 @@ const CodeArea = styled__default.default.textarea`
   line-height: 1.5;
   white-space: pre;
   tab-size: 2;
-`;
+`, VIEW_SIBLINGS_QUERY = '*[_type == "translation.metadata" && references($id)][0].translations[]{"language": _key, "doc": value->}';
 function ViewLocjsonButton(props) {
-  const { docId, type, sourceIsPublished, client, schema, sourceLanguage, documentI18nLanguageField, fieldI18nLanguageField } = props, [open, setOpen] = react.useState(!1), [content, setContent] = react.useState(null), [filename, setFilename] = react.useState(null), [error, setError] = react.useState(null), build = react.useCallback(async () => {
-    setOpen(!0), setContent(null), setFilename(null), setError(null);
-    try {
-      const raw = await client.fetch(
-        sourceIsPublished ? "*[_id == $id][0]" : 'coalesce(*[_id == "drafts." + $id][0], *[_id == $id][0])',
-        { id: docId }
-      );
-      if (!raw) throw new Error(`Document not found: ${docId}`);
-      const isDraft = typeof raw._id == "string" && raw._id.startsWith("drafts."), doc = isDraft ? { ...raw, _id: docId } : raw, fields = locjson.getTranslatableFields(schema.get(type), { exclude: [documentI18nLanguageField] }), locjson$1 = locjson.serializeToLocjson(doc, fields, {
-        sourceLanguage,
-        fieldLanguageKey: fieldI18nLanguageField
-      }), smartcatName = locjson.buildLocjsonFilename(type, docId, resolveDocumentTitle(schema, doc), { draft: isDraft });
-      setFilename(smartcatName.split("/").pop() || smartcatName), setContent(JSON.stringify(locjson$1, null, 2));
-    } catch (err) {
-      setError(err instanceof Error ? err.message : String(err));
-    }
-  }, [client, schema, docId, type, sourceIsPublished, sourceLanguage, documentI18nLanguageField, fieldI18nLanguageField]), download = react.useCallback(() => {
+  const { docId, type, sourceIsPublished, client, schema, sourceLanguage, documentI18nLanguageField, fieldI18nLanguageField, targetLanguages, languages } = props, [open, setOpen] = react.useState(!1), [content, setContent] = react.useState(null), [filename, setFilename] = react.useState(null), [title, setTitle] = react.useState("Source only"), [error, setError] = react.useState(null), build = react.useCallback(
+    async (targetLanguage) => {
+      setOpen(!0), setContent(null), setFilename(null), setError(null), setTitle(targetLanguage ? `Source + ${languageTitle(languages, targetLanguage)}` : "Source only");
+      try {
+        const raw = await client.fetch(
+          sourceIsPublished ? "*[_id == $id][0]" : 'coalesce(*[_id == "drafts." + $id][0], *[_id == $id][0])',
+          { id: docId }
+        );
+        if (!raw) throw new Error(`Document not found: ${docId}`);
+        const isDraft = typeof raw._id == "string" && raw._id.startsWith("drafts."), doc = isDraft ? { ...raw, _id: docId } : raw, fields = locjson.getTranslatableFields(schema.get(type), { exclude: [documentI18nLanguageField] });
+        let target;
+        if (targetLanguage)
+          if (locjson.localizationMode(schema.get(type)) === "document") {
+            const sibling = (await client.fetch(VIEW_SIBLINGS_QUERY, { id: docId }) ?? []).find((v) => v.language === targetLanguage)?.doc ?? void 0;
+            target = { language: targetLanguage, doc: sibling };
+          } else
+            target = { language: targetLanguage };
+        const locjson$1 = locjson.serializeToLocjson(doc, fields, {
+          sourceLanguage,
+          fieldLanguageKey: fieldI18nLanguageField,
+          target
+        }), smartcatCode = targetLanguage ? languages.find((l) => l.id === targetLanguage)?.smartcatLanguage || targetLanguage : void 0, smartcatName = locjson.buildLocjsonFilename(type, docId, resolveDocumentTitle(schema, doc), {
+          draft: isDraft,
+          language: smartcatCode
+        });
+        setFilename(smartcatName.split("/").pop() || smartcatName), setContent(JSON.stringify(locjson$1, null, 2));
+      } catch (err) {
+        setError(err instanceof Error ? err.message : String(err));
+      }
+    },
+    [client, schema, docId, type, sourceIsPublished, sourceLanguage, documentI18nLanguageField, fieldI18nLanguageField, languages]
+  ), download = react.useCallback(() => {
     if (content == null || !filename) return;
     const url = URL.createObjectURL(new Blob([content], { type: "application/json" })), anchor = document.createElement("a");
     anchor.href = url, anchor.download = filename, anchor.click(), URL.revokeObjectURL(url);
   }, [content, filename]);
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(
-      ui.Button,
+      ui.MenuButton,
       {
-        mode: "bleed",
-        icon: icons.JsonIcon,
-        title: "View LocJSON",
-        fontSize: 0,
-        padding: 2,
-        onClick: build
+        id: `locjson-menu-${docId}`,
+        button: /* @__PURE__ */ jsxRuntime.jsx(ui.Button, { mode: "bleed", icon: icons.JsonIcon, iconRight: icons.ChevronDownIcon, title: "View LocJSON", fontSize: 0, padding: 2 }),
+        menu: /* @__PURE__ */ jsxRuntime.jsxs(ui.Menu, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(ui.MenuItem, { text: "Source only", onClick: () => build() }),
+          targetLanguages.map((lang) => /* @__PURE__ */ jsxRuntime.jsx(ui.MenuItem, { text: `Source + ${languageTitle(languages, lang)}`, onClick: () => build(lang) }, lang))
+        ] }),
+        popover: { portal: !0 }
       }
     ),
     open && /* @__PURE__ */ jsxRuntime.jsx(
@@ -1504,7 +1607,9 @@ function ViewLocjsonButton(props) {
         header: /* @__PURE__ */ jsxRuntime.jsxs(ui.Flex, { align: "center", gap: 3, children: [
           /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { weight: "semibold", children: [
             "LocJSON \xB7 ",
-            type
+            type,
+            " \xB7 ",
+            title
           ] }),
           /* @__PURE__ */ jsxRuntime.jsx(
             ui.Button,
@@ -1918,6 +2023,16 @@ Smartcat language code: '${l.smartcatLanguage || l.id}'`,
                       children: modeByType.get(item.doc._type) === "field" ? "fields" : "document"
                     }
                   ),
+                  /* @__PURE__ */ jsxRuntime.jsx(
+                    ui.Badge,
+                    {
+                      tone: item.sendExistingTranslations ? "primary" : "default",
+                      fontSize: 0,
+                      paddingX: 2,
+                      title: item.sendExistingTranslations ? "Existing translations are uploaded to Smartcat (one bilingual file per language) and marked confirmed" : "Only source text is sent; Smartcat translates from scratch",
+                      children: item.sendExistingTranslations ? "source + translations" : "source only"
+                    }
+                  ),
                   item.doc && /* @__PURE__ */ jsxRuntime.jsx(OpenInStudioButton, { id: item.doc._id, type: item.doc._type }),
                   item.doc && /* @__PURE__ */ jsxRuntime.jsx(
                     ViewLocjsonButton,
@@ -1929,7 +2044,9 @@ Smartcat language code: '${l.smartcatLanguage || l.id}'`,
                       schema,
                       sourceLanguage,
                       documentI18nLanguageField,
-                      fieldI18nLanguageField
+                      fieldI18nLanguageField,
+                      targetLanguages: targets,
+                      languages
                     }
                   )
                 ] }),