@elytracms/studio 0.0.102 → 0.0.103

package/dist/components/ai/translate-document-dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"translate-document-dialog.js","sourceRoot":"","sources":["../../../src/components/ai/translate-document-dialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { createCollectionRegistry } from '@elytracms/core/cms-core'\nimport { Check, Languages, Loader2, X } from 'lucide-react'\nimport {\n  Badge,\n  Button,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n  Row,\n  Stack,\n  Text,\n} from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\nimport { localeChipLabel } from '../../lib/locale'\nimport { getStudioOperations } from '../../lib/operations'\nimport { resolveDeploymentAi } from '../../lib/workspace'\nimport { resolveAiConfig, resolveKnowledge, translateDocument } from '../../lib/ai'\nimport type { TranslateProgress, TranslateSkip } from '../../lib/ai'\nimport { cmsValidationIssueMessage } from '../../lib/persona/labels'\nimport { useCms } from '../cms/cms-store'\nimport type { TranslateDocumentActionProps } from './translate-document-action'\nimport { TranslateSkipped } from './translate-skipped'\n\n/**\n * The \"Translate document\" confirm + progress dialog (EC-332), heavy side — loaded lazily\n * by the gate so the AI engine stays off the critical path (EC-331 bundle discipline). A\n * modal is allowed here (a picker/confirmation, per the house rule — property forms are\n * not). It resolves the EC-331 provider + knowledge, runs the ONE `translateDocument`\n * engine over the live draft (fill-empty-only on EC-318 connection state), streams\n * progress, then writes the result to the DRAFT via the operations layer with a\n * provenance-tagged snapshot (mirroring the EC-199 apply) and reflects it into the open\n * editor. Cancel aborts cleanly — any already-translated units stay on the draft, visible\n * in Compare (EC-317) and rejectable via Discard (EC-316).\n */\ntype Phase = 'confirm' | 'running' | 'done' | 'error'\n\ninterface RunSummary {\n  translated: number\n  slugs: number\n  locales: number\n  cancelled: boolean\n  nothing: boolean\n  /** EC-593: every text position the run could not translate — listed, never silent. */\n  skipped: readonly TranslateSkip[]\n}\n\nexport function TranslateDocumentDialog({\n  projectId,\n  collection,\n  docRef,\n  document,\n  revision,\n  localeConfig,\n  flushDraft,\n  open,\n  onOpenChange,\n}: TranslateDocumentActionProps & { open: boolean; onOpenChange: (open: boolean) => void }) {\n  const [phase, setPhase] = useState<Phase>('confirm')\n  const [progress, setProgress] = useState<TranslateProgress | null>(null)\n  const [summary, setSummary] = useState<RunSummary | null>(null)\n  /**\n   * EC-497 — why the refusal was blocked, when the gate refused. Reuses the\n   * EC-473 `ai.error.applyInvalid` copy (\"the proposal no longer fits the current\n   * document: …\"), which is exactly this situation: no new catalog string, and the\n   * editor is told WHICH rules the translation would have broken rather than a bare\n   * \"failed\".\n   */\n  const [refusal, setRefusal] = useState<string | null>(null)\n  const abortRef = useRef<AbortController | null>(null)\n  const cms = useCms()\n  // The session registry the produced draft is judged against. Built here rather\n  // than added to the CMS store's public surface for one consumer; the memo means\n  // once per open, not once per render.\n  const registry = useMemo(() => createCollectionRegistry(cms.collections), [cms.collections])\n\n  useEffect(() => () => abortRef.current?.abort(), [])\n\n  const base = localeConfig.default\n  const targets = localeConfig.locales.filter((l) => l !== base)\n\n  const run = useCallback(async () => {\n    if (projectId === undefined) {\n      setPhase('error')\n      return\n    }\n    const resolved = resolveAiConfig(resolveDeploymentAi())\n    const provider = resolved.resolved?.provider\n    if (!provider || !resolved.ok) {\n      setPhase('error')\n      return\n    }\n    const controller = new AbortController()\n    abortRef.current = controller\n    setRefusal(null)\n    setPhase('running')\n    await flushDraft()\n    setProgress({ completed: 0, total: 0 })\n    try {\n      const knowledge = await resolveKnowledge(resolved.resolved?.knowledge ?? [])\n      const result = await translateDocument({\n        provider,\n        collection,\n        document,\n        localeConfig,\n        knowledge,\n        signal: controller.signal,\n        onProgress: setProgress,\n        // EC-497 — this action used to hand `translateDocument`'s output STRAIGHT to\n        // `documents.upsert` with nothing in between: no gate, no proposal card, no\n        // re-validation, so model-generated content reached the document completely\n        // unvalidated while the chat path validated twice. It now validates with the\n        // session's canonical bag (`cms.validateOptions`) — the editor's own rules —\n        // and refuses below on what the translation INTRODUCED.\n        registry,\n        validateOptions: cms.validateOptions,\n      })\n      if (result.introducedErrors.length > 0) {\n        setRefusal(\n          translate('ai.error.applyInvalid', {\n            issues: result.introducedErrors\n              .slice(0, 3)\n              .map((issue) => cmsValidationIssueMessage(issue))\n              .join('; '),\n          }),\n        )\n        setPhase('error')\n        return\n      }\n      if (result.translated > 0 || result.slugsDerived > 0) {\n        // EC-595 A2: the translation persists as the patches of the buckets it filled\n        // (never the whole document) — through the session's queue, at the revision\n        // the draft it was authored on is at (EC-647); a bucket a colleague changed\n        // meanwhile is refused on that field and shown there.\n        const outcome = await cms.commitPatches(\n          docRef,\n          result.patches,\n          result.patches.map(() => revision),\n        )\n        if (outcome?.status === 'failed') {\n          setPhase('error')\n          return\n        }\n        const { operations } = await getStudioOperations()\n        // Provenance: an AI-tagged version snapshot (best-effort — the draft already landed).\n        try {\n          await operations.documents.snapshot({\n            projectId,\n            ref: docRef,\n            label: translate('cms.version.aiAuthoredTitle'),\n            origin: 'assistant',\n          })\n        } catch {\n          // ignore — provenance is additive\n        }\n      }\n      setSummary({\n        translated: result.translated,\n        slugs: result.slugsDerived,\n        locales: Object.keys(result.perLocale).length,\n        cancelled: result.cancelled,\n        nothing: result.total === 0 && result.skipped.length === 0,\n        skipped: result.skipped,\n      })\n      setPhase('done')\n    } catch {\n      setPhase('error')\n    } finally {\n      abortRef.current = null\n    }\n  }, [projectId, collection, document, revision, localeConfig, docRef, flushDraft, registry, cms])\n\n  const close = () => {\n    if (phase === 'running') return // never close mid-run — Cancel aborts instead\n    onOpenChange(false)\n  }\n\n  const doneMessage = (s: RunSummary): string => {\n    if (s.nothing) return translate('ai.translate.nothing')\n    if (s.cancelled) return translate('ai.translate.cancelled')\n    return translate('ai.translate.applied', { count: s.translated, locales: s.locales })\n  }\n\n  return (\n    <Dialog open={open} onOpenChange={(next) => (!next ? close() : undefined)}>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>\n            <Row gap=\"2\" align=\"center\">\n              <Languages className=\"size-4\" /> {translate('ai.translate.dialogTitle')}\n            </Row>\n          </DialogTitle>\n          <DialogDescription>\n            {translate('ai.translate.dialogDescription', { base: localeChipLabel(base) })}\n          </DialogDescription>\n        </DialogHeader>\n\n        {phase === 'confirm' ? (\n          <Stack gap=\"4\" className=\"py-2\">\n            <Stack gap=\"1\">\n              <Text size=\"xs\" weight=\"medium\" tone=\"muted\">\n                {translate('ai.translate.targetsLabel')}\n              </Text>\n              <Row gap=\"1\" wrap>\n                {targets.map((l) => (\n                  <Badge key={l} variant=\"outline\">\n                    {localeChipLabel(l)}\n                  </Badge>\n                ))}\n              </Row>\n            </Stack>\n            <Stack gap=\"1\">\n              <Text size=\"xs\" weight=\"medium\" tone=\"muted\">\n                {translate('ai.translate.scopeLabel')}\n              </Text>\n              <Row gap=\"2\" align=\"center\">\n                <Badge variant=\"default\">{translate('ai.translate.fillMissing')}</Badge>\n                <Button size=\"sm\" variant=\"ghost\" disabled title={translate('ai.translate.retranslateSoon')}>\n                  {translate('ai.translate.retranslateAll')}\n                </Button>\n                <Text size=\"xs\" tone=\"muted\">\n                  {translate('ai.translate.retranslateSoon')}\n                </Text>\n              </Row>\n            </Stack>\n          </Stack>\n        ) : null}\n\n        {phase === 'running' ? (\n          <Stack gap=\"3\" align=\"center\" className=\"py-6\">\n            <Loader2 className=\"size-6 animate-spin text-primary\" />\n            <Text size=\"sm\" tone=\"muted\" data-testid=\"translate-progress\">\n              {progress && progress.total > 0\n                ? translate('ai.translate.progress', { completed: progress.completed, total: progress.total })\n                : translate('ai.translate.preparing')}\n            </Text>\n            {progress && progress.total > 0 ? (\n              <div className=\"h-1.5 w-56 overflow-hidden rounded-full bg-muted\">\n                <div\n                  className=\"h-full rounded-full bg-primary transition-all\"\n                  style={{ width: `${Math.round((progress.completed / progress.total) * 100)}%` }}\n                />\n              </div>\n            ) : null}\n          </Stack>\n        ) : null}\n\n        {phase === 'done' && summary ? (\n          <Stack gap=\"2\" align=\"center\" className=\"py-6\">\n            <Check className=\"size-6 text-success\" />\n            <Text size=\"sm\" tone=\"muted\" className=\"text-center\" data-testid=\"translate-summary\">\n              {doneMessage(summary)}\n            </Text>\n            <TranslateSkipped skipped={summary.skipped} collection={collection} />\n          </Stack>\n        ) : null}\n\n        {phase === 'error' ? (\n          <Stack gap=\"2\" align=\"center\" className=\"py-6\">\n            <X className=\"size-6 text-destructive\" />\n            <Text size=\"sm\" tone=\"muted\" className=\"text-center\" data-testid=\"translate-error\">\n              {refusal ?? translate('ai.translate.failed')}\n            </Text>\n          </Stack>\n        ) : null}\n\n        <DialogFooter className=\"mt-2\">\n          {phase === 'confirm' ? (\n            <>\n              <Button variant=\"ghost\" size=\"sm\" onClick={close}>\n                {translate('common.cancel')}\n              </Button>\n              <Button size=\"sm\" onClick={() => void run()} data-testid=\"translate-confirm\">\n                <Languages /> {translate('ai.translate.confirm')}\n              </Button>\n            </>\n          ) : phase === 'running' ? (\n            <Button variant=\"outline\" size=\"sm\" onClick={() => abortRef.current?.abort()} data-testid=\"translate-cancel\">\n              {translate('common.cancel')}\n            </Button>\n          ) : (\n            <Button size=\"sm\" onClick={close} data-testid=\"translate-close\">\n              {translate('ai.translate.close')}\n            </Button>\n          )}\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n"]}
+{"version":3,"file":"translate-document-dialog.js","sourceRoot":"","sources":["../../../src/components/ai/translate-document-dialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport { createCollectionRegistry } from '@elytracms/core/cms-core'\nimport type { CollectionDef, Locale } from '@elytracms/core/cms-core'\nimport { Check, Languages, Loader2, X } from 'lucide-react'\nimport {\n  Badge,\n  Button,\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n  Row,\n  SegmentedControl,\n  Stack,\n  Text,\n} from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\nimport { localeChipLabel } from '../../lib/locale'\nimport { getStudioOperations } from '../../lib/operations'\nimport { resolveDeploymentAi } from '../../lib/workspace'\nimport { planTranslation, resolveAiConfig, resolveKnowledge, translateDocument } from '../../lib/ai'\nimport type { TranslateMode, TranslatePlan, TranslateProgress, TranslateSkip, TranslateWrite } from '../../lib/ai'\nimport { applyTranslation } from '../../lib/ai/translate-apply'\nimport { cmsValidationIssueMessage } from '../../lib/persona/labels'\nimport { useCms } from '../cms/cms-store'\nimport type { TranslateDocumentActionProps } from './translate-document-action'\nimport { TranslateBucketList, TranslateSkipped } from './translate-skipped'\n\n/**\n * The \"Translate document\" confirm + progress dialog (EC-332), heavy side — loaded lazily\n * by the gate so the AI engine stays off the critical path (EC-331 bundle discipline). A\n * modal is allowed here (a picker/confirmation, per the house rule — property forms are\n * not). It resolves the EC-331 provider + knowledge, runs the ONE `translateDocument`\n * engine over the live draft, streams progress, then writes the result to the DRAFT via\n * the session (`applyTranslation`) and reflects it into the open editor.\n *\n * The scope is a choice (EC-752): **Fill missing** (the default — only values still\n * connected to the base, EC-318; nothing is overwritten) or **Re-translate everything**,\n * which also REPLACES values with their own translation. Choosing it shows the run's own\n * pre-provider plan (`planTranslation` — what it replaces, fills and leaves as it is), and\n * running it takes the deliberate \"Re-translate and replace\". It snapshots the draft as a\n * labelled version BEFORE writing, so Versions brings any replaced value back; it never\n * touches a slug the editor set and writes a value only whole. The done summary reports\n * what was actually written.\n *\n * Cancel aborts cleanly: fill-empty keeps the already-translated units on the draft;\n * re-translate keeps only values whose every unit landed. Either way the result is visible\n * in Compare (EC-317).\n */\ntype Phase = 'confirm' | 'running' | 'done' | 'error'\n\n/** What the done phase reports — what the run actually wrote, against what it planned. */\nexport interface TranslateRunSummary {\n  mode: TranslateMode\n  plan: TranslatePlan\n  /** Units translated (the fill message's count). */\n  translated: number\n  locales: number\n  cancelled: boolean\n  /** EC-752: the writes that landed (a write refused at its revision is in {@link refused}). */\n  writes: readonly TranslateWrite[]\n  refused: readonly TranslateWrite[]\n  /** EC-752: the version saved before a re-translation wrote. */\n  restorePoint?: number\n  /** EC-593: every text position the run could not translate — listed, never silent. */\n  skipped: readonly TranslateSkip[]\n}\n\nexport function TranslateDocumentDialog({\n  projectId,\n  collection,\n  docRef,\n  document,\n  revision,\n  localeConfig,\n  flushDraft,\n  open,\n  onOpenChange,\n}: TranslateDocumentActionProps & { open: boolean; onOpenChange: (open: boolean) => void }) {\n  const [phase, setPhase] = useState<Phase>('confirm')\n  const [mode, setMode] = useState<TranslateMode>('fill-empty')\n  const [progress, setProgress] = useState<TranslateProgress | null>(null)\n  const [summary, setSummary] = useState<TranslateRunSummary | null>(null)\n  /**\n   * EC-497 — why the refusal was blocked, when the gate refused. Reuses the\n   * EC-473 `ai.error.applyInvalid` copy (\"the proposal no longer fits the current\n   * document: …\"), which is exactly this situation: no new catalog string, and the\n   * editor is told WHICH rules the translation would have broken rather than a bare\n   * \"failed\". EC-752: also why a re-translation wrote nothing (no restore point).\n   */\n  const [refusal, setRefusal] = useState<string | null>(null)\n  const abortRef = useRef<AbortController | null>(null)\n  const cms = useCms()\n  // The session registry the produced draft is judged against. Built here rather\n  // than added to the CMS store's public surface for one consumer; the memo means\n  // once per open, not once per render.\n  const registry = useMemo(() => createCollectionRegistry(cms.collections), [cms.collections])\n\n  useEffect(() => () => abortRef.current?.abort(), [])\n\n  const base = localeConfig.default\n  const targets = localeConfig.locales.filter((l) => l !== base)\n  // EC-752 rule 4: the confirm lists the run's OWN plan — the same judge, on the same input.\n  const plan = useMemo(\n    () =>\n      mode === 'retranslate-all'\n        ? planTranslation({ collection, document, localeConfig, mode, validateOptions: cms.validateOptions })\n        : null,\n    [mode, collection, document, localeConfig, cms.validateOptions],\n  )\n\n  const run = useCallback(async () => {\n    if (projectId === undefined) {\n      setPhase('error')\n      return\n    }\n    const resolved = resolveAiConfig(resolveDeploymentAi())\n    const provider = resolved.resolved?.provider\n    if (!provider || !resolved.ok) {\n      setPhase('error')\n      return\n    }\n    const controller = new AbortController()\n    abortRef.current = controller\n    setRefusal(null)\n    setPhase('running')\n    await flushDraft()\n    setProgress({ completed: 0, total: 0 })\n    try {\n      const knowledge = await resolveKnowledge(resolved.resolved?.knowledge ?? [])\n      const result = await translateDocument({\n        provider,\n        collection,\n        document,\n        localeConfig,\n        mode,\n        knowledge,\n        signal: controller.signal,\n        onProgress: setProgress,\n        // EC-497 — this action used to hand `translateDocument`'s output STRAIGHT to\n        // `documents.upsert` with nothing in between: no gate, no proposal card, no\n        // re-validation, so model-generated content reached the document completely\n        // unvalidated while the chat path validated twice. It now validates with the\n        // session's canonical bag (`cms.validateOptions`) — the editor's own rules —\n        // and refuses below on what the translation INTRODUCED.\n        registry,\n        validateOptions: cms.validateOptions,\n      })\n      if (result.introducedErrors.length > 0) {\n        setRefusal(\n          translate('ai.error.applyInvalid', {\n            issues: result.introducedErrors\n              .slice(0, 3)\n              .map((issue) => cmsValidationIssueMessage(issue))\n              .join('; '),\n          }),\n        )\n        setPhase('error')\n        return\n      }\n      const { operations } = await getStudioOperations()\n      // EC-752 rule 3 (in `applyTranslation`): a re-translation records a labelled restore\n      // point of the stored draft BEFORE it writes; then the patches go through the session's\n      // queue at the revision the draft was authored on (EC-595 A2 / EC-647 — a bucket a\n      // colleague changed meanwhile is refused on that field and shown there); then the\n      // AI-provenance snapshot.\n      const applied = await applyTranslation(\n        result,\n        {\n          commit: (patches) => cms.commitPatches(docRef, patches, patches.map(() => revision)),\n          snapshot: async ({ label, origin }) => {\n            const recorded = await operations.documents.snapshot({\n              projectId,\n              ref: docRef,\n              label,\n              ...(origin ? { origin } : {}),\n            })\n            if (!recorded.ok) throw new Error(recorded.error.message)\n            return recorded.value\n          },\n        },\n        { restorePoint: translate('ai.translate.snapshotLabel'), provenance: translate('cms.version.aiAuthoredTitle') },\n      )\n      if (applied.status === 'snapshot-failed') {\n        setRefusal(translate('ai.translate.snapshotFailed'))\n        setPhase('error')\n        return\n      }\n      if (applied.status === 'failed') {\n        setPhase('error')\n        return\n      }\n      setSummary({\n        mode,\n        plan: result.plan,\n        translated: result.translated,\n        locales: Object.keys(result.perLocale).length,\n        cancelled: result.cancelled,\n        writes: applied.writes,\n        refused: applied.refused,\n        ...(applied.restorePoint !== undefined ? { restorePoint: applied.restorePoint } : {}),\n        skipped: result.skipped,\n      })\n      setPhase('done')\n    } catch {\n      setPhase('error')\n    } finally {\n      abortRef.current = null\n    }\n  }, [projectId, collection, document, revision, localeConfig, mode, docRef, flushDraft, registry, cms])\n\n  const close = () => {\n    if (phase === 'running') return // never close mid-run — Cancel aborts instead\n    onOpenChange(false)\n  }\n\n  const replaces = (plan?.buckets ?? []).some((bucket) => bucket.kind === 'replace')\n\n  return (\n    <Dialog open={open} onOpenChange={(next) => (!next ? close() : undefined)}>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>\n            <Row gap=\"2\" align=\"center\">\n              <Languages className=\"size-4\" /> {translate('ai.translate.dialogTitle')}\n            </Row>\n          </DialogTitle>\n          <DialogDescription>\n            {translate('ai.translate.dialogDescription', { base: localeChipLabel(base) })}\n          </DialogDescription>\n        </DialogHeader>\n\n        {phase === 'confirm' ? (\n          <TranslateConfirm\n            mode={mode}\n            onModeChange={setMode}\n            base={base}\n            targets={targets}\n            plan={plan}\n            collection={collection}\n          />\n        ) : null}\n\n        {phase === 'running' ? (\n          <Stack gap=\"3\" align=\"center\" className=\"py-6\">\n            <Loader2 className=\"size-6 animate-spin text-primary\" />\n            <Text size=\"sm\" tone=\"muted\" data-testid=\"translate-progress\">\n              {progress && progress.total > 0\n                ? translate('ai.translate.progress', { completed: progress.completed, total: progress.total })\n                : translate('ai.translate.preparing')}\n            </Text>\n            {progress && progress.total > 0 ? (\n              <div className=\"h-1.5 w-56 overflow-hidden rounded-full bg-muted\">\n                <div\n                  className=\"h-full rounded-full bg-primary transition-all\"\n                  style={{ width: `${Math.round((progress.completed / progress.total) * 100)}%` }}\n                />\n              </div>\n            ) : null}\n          </Stack>\n        ) : null}\n\n        {phase === 'done' && summary ? (\n          <Stack gap=\"2\" align=\"center\" className=\"py-6\">\n            <Check className=\"size-6 text-success\" />\n            <TranslateDoneSummary summary={summary} base={base} collection={collection} />\n          </Stack>\n        ) : null}\n\n        {phase === 'error' ? (\n          <Stack gap=\"2\" align=\"center\" className=\"py-6\">\n            <X className=\"size-6 text-destructive\" />\n            <Text size=\"sm\" tone=\"muted\" className=\"text-center\" data-testid=\"translate-error\">\n              {refusal ?? translate('ai.translate.failed')}\n            </Text>\n          </Stack>\n        ) : null}\n\n        <DialogFooter className=\"mt-2\">\n          {phase === 'confirm' ? (\n            <>\n              <Button variant=\"ghost\" size=\"sm\" onClick={close}>\n                {translate('common.cancel')}\n              </Button>\n              {mode === 'retranslate-all' && replaces ? (\n                // EC-752: the deliberate confirm — the button says what it does.\n                <Button size=\"sm\" variant=\"destructive\" onClick={() => void run()} data-testid=\"translate-confirm\">\n                  <Languages /> {translate('ai.translate.confirmReplace')}\n                </Button>\n              ) : (\n                <Button size=\"sm\" onClick={() => void run()} data-testid=\"translate-confirm\">\n                  <Languages /> {translate('ai.translate.confirm')}\n                </Button>\n              )}\n            </>\n          ) : phase === 'running' ? (\n            <Button variant=\"outline\" size=\"sm\" onClick={() => abortRef.current?.abort()} data-testid=\"translate-cancel\">\n              {translate('common.cancel')}\n            </Button>\n          ) : (\n            <Button size=\"sm\" onClick={close} data-testid=\"translate-close\">\n              {translate('ai.translate.close')}\n            </Button>\n          )}\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n\n/**\n * EC-752 — the confirm phase: the target languages, the scope choice and, for a\n * re-translation, its plan (what it replaces, fills and leaves as it is — \"up to\").\n */\nexport function TranslateConfirm({\n  mode,\n  onModeChange,\n  base,\n  targets,\n  plan,\n  collection,\n}: {\n  mode: TranslateMode\n  onModeChange: (mode: TranslateMode) => void\n  base: Locale\n  targets: readonly Locale[]\n  /** The run's plan — present in `retranslate-all`. */\n  plan: TranslatePlan | null\n  collection: CollectionDef\n}) {\n  const baseLabel = localeChipLabel(base)\n  return (\n    <Stack gap=\"4\" className=\"py-2\">\n      <Stack gap=\"1\">\n        <Text size=\"xs\" weight=\"medium\" tone=\"muted\">\n          {translate('ai.translate.targetsLabel')}\n        </Text>\n        <Row gap=\"1\" wrap>\n          {targets.map((l) => (\n            <Badge key={l} variant=\"outline\">\n              {localeChipLabel(l)}\n            </Badge>\n          ))}\n        </Row>\n      </Stack>\n      <Stack gap=\"1\">\n        <Text size=\"xs\" weight=\"medium\" tone=\"muted\">\n          {translate('ai.translate.scopeLabel')}\n        </Text>\n        <SegmentedControl\n          ariaLabel={translate('ai.translate.scopeLabel')}\n          testId=\"translate-scope\"\n          items={[\n            {\n              key: 'fill-empty',\n              label: translate('ai.translate.fillMissing'),\n              active: mode === 'fill-empty',\n              onClick: () => onModeChange('fill-empty'),\n              testId: 'translate-scope-fill',\n            },\n            {\n              key: 'retranslate-all',\n              label: translate('ai.translate.retranslateAll'),\n              active: mode === 'retranslate-all',\n              onClick: () => onModeChange('retranslate-all'),\n              testId: 'translate-scope-retranslate',\n            },\n          ]}\n        />\n        <Text size=\"xs\" tone=\"muted\">\n          {translate(mode === 'retranslate-all' ? 'ai.translate.retranslateHint' : 'ai.translate.fillMissingHint', {\n            base: baseLabel,\n          })}\n        </Text>\n      </Stack>\n      {mode === 'retranslate-all' && plan ? <RetranslatePlan plan={plan} base={base} collection={collection} /> : null}\n    </Stack>\n  )\n}\n\n/** EC-752 rule 4 — what a re-translation will do, from its own pre-provider plan. */\nfunction RetranslatePlan({ plan, base, collection }: { plan: TranslatePlan; base: Locale; collection: CollectionDef }) {\n  const baseLabel = localeChipLabel(base)\n  const replace = plan.buckets.filter((bucket) => bucket.kind === 'replace')\n  const fill = plan.buckets.filter((bucket) => bucket.kind === 'fill')\n  return (\n    <Stack gap=\"2\" data-testid=\"translate-plan\">\n      {replace.length > 0 ? (\n        <TranslateBucketList\n          title={translate('ai.translate.planReplaceTitle', { base: baseLabel, count: replace.length })}\n          buckets={replace}\n          collection={collection}\n          testId=\"translate-plan-replace\"\n        />\n      ) : (\n        <Text size=\"xs\" tone=\"muted\">\n          {translate('ai.translate.planReplaceNone')}\n        </Text>\n      )}\n      <TranslateBucketList\n        title={translate('ai.translate.planFillTitle', { base: baseLabel, count: fill.length })}\n        buckets={fill}\n        collection={collection}\n        testId=\"translate-plan-fill\"\n      />\n      <TranslateSkipped\n        skipped={plan.skipped}\n        collection={collection}\n        mode={plan.mode}\n        title={translate('ai.translate.planKeptTitle', { count: plan.skipped.length })}\n      />\n      <Stack gap=\"px\">\n        <Text size=\"xs\" tone=\"muted\">\n          {translate('ai.translate.planWhole')}\n        </Text>\n        <Text size=\"xs\" tone=\"muted\">\n          {translate('ai.translate.planSlugsKept')}\n        </Text>\n        {replace.length > 0 ? (\n          <Text size=\"xs\" tone=\"muted\">\n            {translate('ai.translate.planRestorePoint')}\n          </Text>\n        ) : null}\n      </Stack>\n    </Stack>\n  )\n}\n\n/** The headline of the done phase (EC-752: mode-aware; slugs and replacements are listed below it). */\nexport function translateDoneMessage(summary: TranslateRunSummary, base: Locale): string {\n  const retranslate = summary.mode === 'retranslate-all'\n  const nothing =\n    summary.plan.total === 0 && summary.skipped.length === 0 && summary.writes.length === 0 && summary.refused.length === 0\n  if (nothing) {\n    return retranslate\n      ? translate('ai.translate.retranslateNothing', { base: localeChipLabel(base) })\n      : translate('ai.translate.nothing')\n  }\n  if (summary.cancelled) return translate(retranslate ? 'ai.translate.retranslateCancelled' : 'ai.translate.cancelled')\n  if (retranslate) return translate('ai.translate.retranslateDone')\n  return translate('ai.translate.applied', { count: summary.translated, locales: summary.locales })\n}\n\n/**\n * EC-752 — the done phase: what was actually written (a re-translation lists what it\n * replaced and filled), the slugs it set, what was refused at its revision, what a\n * re-translation planned but left as it was, its restore point, and what was not translated.\n */\nexport function TranslateDoneSummary({\n  summary,\n  base,\n  collection,\n}: {\n  summary: TranslateRunSummary\n  base: Locale\n  collection: CollectionDef\n}) {\n  const retranslate = summary.mode === 'retranslate-all'\n  const of = (kind: TranslateWrite['kind']) => summary.writes.filter((write) => write.kind === kind)\n  const done = (bucket: { field: string; locale: string }) =>\n    [...summary.writes, ...summary.refused].some((write) => write.field === bucket.field && write.locale === bucket.locale)\n  const kept = retranslate ? summary.plan.buckets.filter((bucket) => !done(bucket)) : []\n  return (\n    <Stack gap=\"2\" className=\"w-full\">\n      <Text size=\"sm\" tone=\"muted\" className=\"text-center\" data-testid=\"translate-summary\">\n        {translateDoneMessage(summary, base)}\n      </Text>\n      {retranslate ? (\n        <>\n          <TranslateBucketList\n            title={translate('ai.translate.replacedTitle', { count: of('replace').length })}\n            buckets={of('replace')}\n            collection={collection}\n            testId=\"translate-replaced\"\n          />\n          <TranslateBucketList\n            title={translate('ai.translate.filledTitle', { count: of('fill').length })}\n            buckets={of('fill')}\n            collection={collection}\n            testId=\"translate-filled\"\n          />\n        </>\n      ) : null}\n      <TranslateBucketList\n        title={translate('ai.translate.slugsTitle', { count: of('slug').length })}\n        buckets={of('slug')}\n        collection={collection}\n        testId=\"translate-slugs\"\n      />\n      <TranslateBucketList\n        title={translate('ai.translate.refusedTitle', { count: summary.refused.length })}\n        buckets={summary.refused}\n        collection={collection}\n        testId=\"translate-refused\"\n      />\n      <TranslateBucketList\n        title={translate('ai.translate.keptTitle', { count: kept.length })}\n        buckets={kept}\n        collection={collection}\n        testId=\"translate-kept\"\n      />\n      {summary.restorePoint !== undefined ? (\n        <Text size=\"xs\" tone=\"muted\" data-testid=\"translate-restore-point\">\n          {translate('ai.translate.restorePoint', { version: summary.restorePoint })}\n        </Text>\n      ) : null}\n      <TranslateSkipped skipped={summary.skipped} collection={collection} mode={summary.mode} />\n    </Stack>\n  )\n}\n"]}

package/dist/components/ai/translate-skipped.d.ts

@@ -1,19 +1,35 @@
 import type { CollectionDef } from '@elytracms/core/cms-core';
-import type { TranslateSkip } from '../../lib/ai/index.js';
+import type { TranslateBucket, TranslateMode, TranslateSkip } from '../../lib/ai/index.js';
 /** One skip as the editor reads it: where (field label › component › position), which language, why. */
 export interface TranslateSkipLine {
     where: string;
     locale: string;
     reason: string;
 }
+/** EC-752 — a field × locale value as the editor reads it: `Title (DE)`. */
+export declare function translateBucketLabel(bucket: TranslateBucket, collection: CollectionDef | undefined): string;
 /**
  * The where-label of a skipped position: the field's label, then — inside a component —
  * the component and its prop path, else the position below the field (an item counted
  * from 1). Index-bearing segments the editor does not see (`content`, `props`) are left out.
  */
-export declare function translateSkipLines(skipped: readonly TranslateSkip[], collection: CollectionDef | undefined): TranslateSkipLine[];
+export declare function translateSkipLines(skipped: readonly TranslateSkip[], collection: CollectionDef | undefined, mode?: TranslateMode): TranslateSkipLine[];
 /** The list; renders nothing when everything was translated. */
-export declare function TranslateSkipped({ skipped, collection, }: {
+export declare function TranslateSkipped({ skipped, collection, mode, title, }: {
     skipped: readonly TranslateSkip[];
     collection: CollectionDef | undefined;
+    /** EC-752: the run's mode — a re-translation's reasons say the whole value was left as it was. */
+    mode?: TranslateMode;
+    /** EC-752: the heading (default "Not translated (n)"); the confirm names what it will leave as it is. */
+    title?: string;
+}): import("react").JSX.Element | null;
+/**
+ * EC-752 — a list of field × locale values under a heading (what a re-translation replaces,
+ * fills, set as slugs or left as it was); renders nothing for an empty list.
+ */
+export declare function TranslateBucketList({ title, buckets, collection, testId, }: {
+    title: string;
+    buckets: readonly TranslateBucket[];
+    collection: CollectionDef | undefined;
+    testId: string;
 }): import("react").JSX.Element | null;

package/dist/components/ai/translate-skipped.js

@@ -9,6 +9,9 @@ import { localeChipLabel } from '../../lib/locale/index.js';
  * editor reads the outcome: the "Translate document" dialog and the chat's translation
  * proposal card. Before, a localized object or composition was skipped with no word,
  * and a garbled rich-text block silently kept its original.
+ *
+ * EC-752 — the reason is MODE-aware: a re-translation writes a value whole or not at all,
+ * so its reasons say the whole value was left as it was (fill-empty fills the rest).
  */
 const REASON_KEY = {
     unreadable: 'ai.translate.skipped.unreadable',
@@ -16,15 +19,29 @@ const REASON_KEY = {
     'structure-changed': 'ai.translate.skipped.structureChanged',
     locked: 'ai.translate.skipped.locked',
 };
+const RETRANSLATE_REASON_KEY = {
+    unreadable: 'ai.translate.skipped.retranslate.unreadable',
+    'not-returned': 'ai.translate.skipped.retranslate.notReturned',
+    'structure-changed': 'ai.translate.skipped.retranslate.structureChanged',
+    locked: 'ai.translate.skipped.locked',
+};
+/** A top-level field's label as the editor reads it (its form label, else its name). */
+function fieldLabel(fieldName, collection) {
+    const field = collection?.fields.find((f) => f.name === fieldName);
+    return resolveLabel(field?.form?.label) ?? fieldName;
+}
+/** EC-752 — a field × locale value as the editor reads it: `Title (DE)`. */
+export function translateBucketLabel(bucket, collection) {
+    return `${fieldLabel(bucket.field, collection)} (${localeChipLabel(bucket.locale)})`;
+}
 /**
  * The where-label of a skipped position: the field's label, then — inside a component —
  * the component and its prop path, else the position below the field (an item counted
  * from 1). Index-bearing segments the editor does not see (`content`, `props`) are left out.
  */
-export function translateSkipLines(skipped, collection) {
+export function translateSkipLines(skipped, collection, mode = 'fill-empty') {
+    const reasons = mode === 'retranslate-all' ? RETRANSLATE_REASON_KEY : REASON_KEY;
     return skipped.map((skip) => {
-        const field = collection?.fields.find((f) => f.name === skip.field);
-        const label = resolveLabel(field?.form?.label) ?? skip.field;
         const below = skip.component
             ? [skip.component.componentId, ...skip.at.slice(skip.at.lastIndexOf('props') + 1)]
             : skip.at;
@@ -32,16 +49,25 @@ export function translateSkipLines(skipped, collection) {
             .filter((segment) => segment !== 'content' && segment !== 'props')
             .map((segment) => (typeof segment === 'number' ? `#${segment + 1}` : segment));
         return {
-            where: [label, ...segments].join(' › '),
+            where: [fieldLabel(skip.field, collection), ...segments].join(' › '),
             locale: localeChipLabel(skip.locale),
-            reason: translate(REASON_KEY[skip.reason]),
+            reason: translate(reasons[skip.reason]),
         };
     });
 }
 /** The list; renders nothing when everything was translated. */
-export function TranslateSkipped({ skipped, collection, }) {
+export function TranslateSkipped({ skipped, collection, mode = 'fill-empty', title, }) {
     if (skipped.length === 0)
         return null;
-    return (_jsxs(Stack, { gap: "1", "data-testid": "translate-skipped", children: [_jsxs(Row, { gap: "1", align: "center", children: [_jsx(AlertTriangle, { className: "size-3.5 text-warning" }), _jsx(Text, { size: "xs", weight: "medium", children: translate('ai.translate.skippedTitle', { count: skipped.length }) })] }), translateSkipLines(skipped, collection).map((line, index) => (_jsxs(Text, { size: "xs", tone: "muted", "data-translate-skip": true, children: [line.where, " (", line.locale, ") \u2014 ", line.reason] }, index)))] }));
+    return (_jsxs(Stack, { gap: "1", "data-testid": "translate-skipped", children: [_jsxs(Row, { gap: "1", align: "center", children: [_jsx(AlertTriangle, { className: "size-3.5 text-warning" }), _jsx(Text, { size: "xs", weight: "medium", children: title ?? translate('ai.translate.skippedTitle', { count: skipped.length }) })] }), translateSkipLines(skipped, collection, mode).map((line, index) => (_jsxs(Text, { size: "xs", tone: "muted", "data-translate-skip": true, children: [line.where, " (", line.locale, ") \u2014 ", line.reason] }, index)))] }));
+}
+/**
+ * EC-752 — a list of field × locale values under a heading (what a re-translation replaces,
+ * fills, set as slugs or left as it was); renders nothing for an empty list.
+ */
+export function TranslateBucketList({ title, buckets, collection, testId, }) {
+    if (buckets.length === 0)
+        return null;
+    return (_jsxs(Stack, { gap: "1", "data-testid": testId, children: [_jsx(Text, { size: "xs", weight: "medium", children: title }), _jsx(Text, { size: "xs", tone: "muted", "data-translate-buckets": true, children: buckets.map((bucket) => translateBucketLabel(bucket, collection)).join(', ') })] }));
 }
 //# sourceMappingURL=translate-skipped.js.map

package/dist/components/ai/translate-skipped.js.map

@@ -1 +1 @@
-{"version":3,"file":"translate-skipped.js","sourceRoot":"","sources":["../../../src/components/ai/translate-skipped.tsx"],"names":[],"mappings":"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","sourcesContent":["import { resolveLabel } from '@elytracms/core/cms-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { AlertTriangle } from 'lucide-react'\nimport { Row, Stack, Text } from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\nimport { localeChipLabel } from '../../lib/locale'\nimport type { TranslateSkip, TranslateSkipReason } from '../../lib/ai'\n\n/**\n * EC-593 (ratified 4e) — what a translation run could NOT translate, shown where the\n * editor reads the outcome: the \"Translate document\" dialog and the chat's translation\n * proposal card. Before, a localized object or composition was skipped with no word,\n * and a garbled rich-text block silently kept its original.\n */\n\nconst REASON_KEY: Record<TranslateSkipReason, string> = {\n  unreadable: 'ai.translate.skipped.unreadable',\n  'not-returned': 'ai.translate.skipped.notReturned',\n  'structure-changed': 'ai.translate.skipped.structureChanged',\n  locked: 'ai.translate.skipped.locked',\n}\n\n/** One skip as the editor reads it: where (field label › component › position), which language, why. */\nexport interface TranslateSkipLine {\n  where: string\n  locale: string\n  reason: string\n}\n\n/**\n * The where-label of a skipped position: the field's label, then — inside a component —\n * the component and its prop path, else the position below the field (an item counted\n * from 1). Index-bearing segments the editor does not see (`content`, `props`) are left out.\n */\nexport function translateSkipLines(\n  skipped: readonly TranslateSkip[],\n  collection: CollectionDef | undefined,\n): TranslateSkipLine[] {\n  return skipped.map((skip) => {\n    const field = collection?.fields.find((f) => f.name === skip.field)\n    const label = resolveLabel(field?.form?.label) ?? skip.field\n    const below = skip.component\n      ? [skip.component.componentId, ...skip.at.slice(skip.at.lastIndexOf('props') + 1)]\n      : skip.at\n    const segments = below\n      .filter((segment) => segment !== 'content' && segment !== 'props')\n      .map((segment) => (typeof segment === 'number' ? `#${segment + 1}` : segment))\n    return {\n      where: [label, ...segments].join(' › '),\n      locale: localeChipLabel(skip.locale),\n      reason: translate(REASON_KEY[skip.reason]),\n    }\n  })\n}\n\n/** The list; renders nothing when everything was translated. */\nexport function TranslateSkipped({\n  skipped,\n  collection,\n}: {\n  skipped: readonly TranslateSkip[]\n  collection: CollectionDef | undefined\n}) {\n  if (skipped.length === 0) return null\n  return (\n    <Stack gap=\"1\" data-testid=\"translate-skipped\">\n      <Row gap=\"1\" align=\"center\">\n        <AlertTriangle className=\"size-3.5 text-warning\" />\n        <Text size=\"xs\" weight=\"medium\">\n          {translate('ai.translate.skippedTitle', { count: skipped.length })}\n        </Text>\n      </Row>\n      {translateSkipLines(skipped, collection).map((line, index) => (\n        <Text key={index} size=\"xs\" tone=\"muted\" data-translate-skip>\n          {line.where} ({line.locale}) — {line.reason}\n        </Text>\n      ))}\n    </Stack>\n  )\n}\n"]}
+{"version":3,"file":"translate-skipped.js","sourceRoot":"","sources":["../../../src/components/ai/translate-skipped.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAGlD;;;;;;;;GAQG;AAEH,MAAM,UAAU,GAAwC;IACtD,UAAU,EAAE,iCAAiC;IAC7C,cAAc,EAAE,kCAAkC;IAClD,mBAAmB,EAAE,uCAAuC;IAC5D,MAAM,EAAE,6BAA6B;CACtC,CAAA;AAED,MAAM,sBAAsB,GAAwC;IAClE,UAAU,EAAE,6CAA6C;IACzD,cAAc,EAAE,8CAA8C;IAC9D,mBAAmB,EAAE,mDAAmD;IACxE,MAAM,EAAE,6BAA6B;CACtC,CAAA;AASD,wFAAwF;AACxF,SAAS,UAAU,CAAC,SAAiB,EAAE,UAAqC;IAC1E,MAAM,KAAK,GAAG,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;IAClE,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,CAAA;AACtD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,MAAuB,EAAE,UAAqC;IACjG,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAiC,EACjC,UAAqC,EACrC,OAAsB,YAAY;IAElC,MAAM,OAAO,GAAG,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,CAAA;IAChF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS;YAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAClF,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;QACX,MAAM,QAAQ,GAAG,KAAK;aACnB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,OAAO,CAAC;aACjE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;QAChF,OAAO;YACL,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACpE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;YACpC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACxC,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,EAC/B,OAAO,EACP,UAAU,EACV,IAAI,GAAG,YAAY,EACnB,KAAK,GAQN;IACC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,CACL,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,iBAAa,mBAAmB,aAC5C,MAAC,GAAG,IAAC,GAAG,EAAC,GAAG,EAAC,KAAK,EAAC,QAAQ,aACzB,KAAC,aAAa,IAAC,SAAS,EAAC,uBAAuB,GAAG,EACnD,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,QAAQ,YAC5B,KAAK,IAAI,SAAS,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,GACtE,IACH,EACL,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAClE,MAAC,IAAI,IAAa,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,0CACrC,IAAI,CAAC,KAAK,QAAI,IAAI,CAAC,MAAM,eAAM,IAAI,CAAC,MAAM,KADlC,KAAK,CAET,CACR,CAAC,IACI,CACT,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,KAAK,EACL,OAAO,EACP,UAAU,EACV,MAAM,GAMP;IACC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,CACL,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,iBAAc,MAAM,aAChC,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,QAAQ,YAC5B,KAAK,GACD,EACP,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,4CACzB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GACxE,IACD,CACT,CAAA;AACH,CAAC","sourcesContent":["import { resolveLabel } from '@elytracms/core/cms-core'\nimport type { CollectionDef } from '@elytracms/core/cms-core'\nimport { AlertTriangle } from 'lucide-react'\nimport { Row, Stack, Text } from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\nimport { localeChipLabel } from '../../lib/locale'\nimport type { TranslateBucket, TranslateMode, TranslateSkip, TranslateSkipReason } from '../../lib/ai'\n\n/**\n * EC-593 (ratified 4e) — what a translation run could NOT translate, shown where the\n * editor reads the outcome: the \"Translate document\" dialog and the chat's translation\n * proposal card. Before, a localized object or composition was skipped with no word,\n * and a garbled rich-text block silently kept its original.\n *\n * EC-752 — the reason is MODE-aware: a re-translation writes a value whole or not at all,\n * so its reasons say the whole value was left as it was (fill-empty fills the rest).\n */\n\nconst REASON_KEY: Record<TranslateSkipReason, string> = {\n  unreadable: 'ai.translate.skipped.unreadable',\n  'not-returned': 'ai.translate.skipped.notReturned',\n  'structure-changed': 'ai.translate.skipped.structureChanged',\n  locked: 'ai.translate.skipped.locked',\n}\n\nconst RETRANSLATE_REASON_KEY: Record<TranslateSkipReason, string> = {\n  unreadable: 'ai.translate.skipped.retranslate.unreadable',\n  'not-returned': 'ai.translate.skipped.retranslate.notReturned',\n  'structure-changed': 'ai.translate.skipped.retranslate.structureChanged',\n  locked: 'ai.translate.skipped.locked',\n}\n\n/** One skip as the editor reads it: where (field label › component › position), which language, why. */\nexport interface TranslateSkipLine {\n  where: string\n  locale: string\n  reason: string\n}\n\n/** A top-level field's label as the editor reads it (its form label, else its name). */\nfunction fieldLabel(fieldName: string, collection: CollectionDef | undefined): string {\n  const field = collection?.fields.find((f) => f.name === fieldName)\n  return resolveLabel(field?.form?.label) ?? fieldName\n}\n\n/** EC-752 — a field × locale value as the editor reads it: `Title (DE)`. */\nexport function translateBucketLabel(bucket: TranslateBucket, collection: CollectionDef | undefined): string {\n  return `${fieldLabel(bucket.field, collection)} (${localeChipLabel(bucket.locale)})`\n}\n\n/**\n * The where-label of a skipped position: the field's label, then — inside a component —\n * the component and its prop path, else the position below the field (an item counted\n * from 1). Index-bearing segments the editor does not see (`content`, `props`) are left out.\n */\nexport function translateSkipLines(\n  skipped: readonly TranslateSkip[],\n  collection: CollectionDef | undefined,\n  mode: TranslateMode = 'fill-empty',\n): TranslateSkipLine[] {\n  const reasons = mode === 'retranslate-all' ? RETRANSLATE_REASON_KEY : REASON_KEY\n  return skipped.map((skip) => {\n    const below = skip.component\n      ? [skip.component.componentId, ...skip.at.slice(skip.at.lastIndexOf('props') + 1)]\n      : skip.at\n    const segments = below\n      .filter((segment) => segment !== 'content' && segment !== 'props')\n      .map((segment) => (typeof segment === 'number' ? `#${segment + 1}` : segment))\n    return {\n      where: [fieldLabel(skip.field, collection), ...segments].join(' › '),\n      locale: localeChipLabel(skip.locale),\n      reason: translate(reasons[skip.reason]),\n    }\n  })\n}\n\n/** The list; renders nothing when everything was translated. */\nexport function TranslateSkipped({\n  skipped,\n  collection,\n  mode = 'fill-empty',\n  title,\n}: {\n  skipped: readonly TranslateSkip[]\n  collection: CollectionDef | undefined\n  /** EC-752: the run's mode — a re-translation's reasons say the whole value was left as it was. */\n  mode?: TranslateMode\n  /** EC-752: the heading (default \"Not translated (n)\"); the confirm names what it will leave as it is. */\n  title?: string\n}) {\n  if (skipped.length === 0) return null\n  return (\n    <Stack gap=\"1\" data-testid=\"translate-skipped\">\n      <Row gap=\"1\" align=\"center\">\n        <AlertTriangle className=\"size-3.5 text-warning\" />\n        <Text size=\"xs\" weight=\"medium\">\n          {title ?? translate('ai.translate.skippedTitle', { count: skipped.length })}\n        </Text>\n      </Row>\n      {translateSkipLines(skipped, collection, mode).map((line, index) => (\n        <Text key={index} size=\"xs\" tone=\"muted\" data-translate-skip>\n          {line.where} ({line.locale}) — {line.reason}\n        </Text>\n      ))}\n    </Stack>\n  )\n}\n\n/**\n * EC-752 — a list of field × locale values under a heading (what a re-translation replaces,\n * fills, set as slugs or left as it was); renders nothing for an empty list.\n */\nexport function TranslateBucketList({\n  title,\n  buckets,\n  collection,\n  testId,\n}: {\n  title: string\n  buckets: readonly TranslateBucket[]\n  collection: CollectionDef | undefined\n  testId: string\n}) {\n  if (buckets.length === 0) return null\n  return (\n    <Stack gap=\"1\" data-testid={testId}>\n      <Text size=\"xs\" weight=\"medium\">\n        {title}\n      </Text>\n      <Text size=\"xs\" tone=\"muted\" data-translate-buckets>\n        {buckets.map((bucket) => translateBucketLabel(bucket, collection)).join(', ')}\n      </Text>\n    </Stack>\n  )\n}\n"]}

package/dist/lib/ai/translate-apply.d.ts

@@ -0,0 +1,69 @@
+import type { DocumentPatch, ValuePath } from '@elytracms/core/cms-core';
+import type { TranslateDocumentResult, TranslateWrite } from './translate-document.js';
+/**
+ * EC-752 — how a translation run's writes land, in order: the pure core of the "Translate
+ * document" dialog's apply (the dialog wires it to the session's commit queue and the
+ * `documents.snapshot` operation), so the order is pinned by a test, not by a component.
+ *
+ * Re-translate everything REPLACES values someone made, and the draft records no history of
+ * its own (versions are recorded on publish, snapshot and restore only), so an unpublished
+ * manual translation it replaced was unrecoverable — the dialog used to snapshot only AFTER
+ * its commit, a restore point holding the post-write state. Now:
+ *
+ *  1. `retranslate-all` with anything to write: a labelled snapshot of the stored draft
+ *     FIRST — the restore point Versions / Compare's scoped restore brings a field back
+ *     from. If it cannot be recorded, nothing is written (`snapshot-failed`): a
+ *     re-translation never replaces what it could not save.
+ *  2. The patches, through the caller's commit (the session's queue, at the revision the
+ *     draft was authored on — a position a colleague changed meanwhile is refused there).
+ *  3. The AI-provenance snapshot (best-effort, as before — the draft already landed).
+ *
+ * `fill-empty` is unchanged: it fills only values that followed the base, so it replaces
+ * nothing and takes no restore point.
+ */
+/** What the caller's commit reports — structurally the session's `CommitOutcome`. */
+export type TranslateCommitOutcome = {
+    readonly status: 'applied';
+} | {
+    readonly status: 'refused';
+    readonly conflicts: readonly {
+        readonly path: ValuePath;
+    }[];
+} | {
+    readonly status: 'failed';
+};
+export interface TranslateApplyDeps {
+    /** Persist the run's patches; `undefined` when the session applied them locally (a fixture session). */
+    commit(patches: readonly DocumentPatch[]): Promise<TranslateCommitOutcome | undefined>;
+    /** Record the current stored draft as a version (`documents.snapshot`). */
+    snapshot(options: {
+        readonly label: string;
+        readonly origin?: string;
+    }): Promise<{
+        readonly version: number;
+    }>;
+}
+export interface TranslateApplyLabels {
+    /** The restore point's label (taken before a re-translation writes). */
+    readonly restorePoint: string;
+    /** The provenance snapshot's label (taken after the write). */
+    readonly provenance: string;
+}
+export type TranslateApplyOutcome = {
+    readonly status: 'applied';
+    /** The writes that landed — the run's writes minus the ones refused at their revision. */
+    readonly writes: readonly TranslateWrite[];
+    /** Writes refused because a colleague changed the position meanwhile (shown as conflicts there). */
+    readonly refused: readonly TranslateWrite[];
+    /** The version recorded before a re-translation wrote — what Versions restores from. */
+    readonly restorePoint?: number;
+}
+/** `retranslate-all`: the restore point could not be recorded, so nothing was written. */
+ | {
+    readonly status: 'snapshot-failed';
+}
+/** The commit failed (transport, authorization): reported by the session too. */
+ | {
+    readonly status: 'failed';
+};
+export declare function applyTranslation(result: Pick<TranslateDocumentResult, 'plan' | 'writes' | 'patches'>, deps: TranslateApplyDeps, labels: TranslateApplyLabels): Promise<TranslateApplyOutcome>;

package/dist/lib/ai/translate-apply.js

@@ -0,0 +1,36 @@
+const pathKey = (path) => JSON.stringify(path ?? null);
+/** The position a field write's patch addresses (`set` / `unset` — the only kinds a translation emits). */
+function patchPath(patch) {
+    return 'path' in patch ? patch.path : undefined;
+}
+export async function applyTranslation(result, deps, labels) {
+    if (result.writes.length === 0)
+        return { status: 'applied', writes: [], refused: [] };
+    let restorePoint;
+    if (result.plan.mode === 'retranslate-all') {
+        try {
+            restorePoint = (await deps.snapshot({ label: labels.restorePoint })).version;
+        }
+        catch {
+            return { status: 'snapshot-failed' };
+        }
+    }
+    const outcome = await deps.commit(result.patches);
+    if (outcome?.status === 'failed')
+        return { status: 'failed' };
+    const refusedAt = new Set(outcome?.status === 'refused' ? outcome.conflicts.map((conflict) => pathKey(conflict.path)) : []);
+    const refused = result.writes.filter((write) => refusedAt.has(pathKey(patchPath(write.patch))));
+    try {
+        await deps.snapshot({ label: labels.provenance, origin: 'assistant' });
+    }
+    catch {
+        // ignore — provenance is additive
+    }
+    return {
+        status: 'applied',
+        writes: result.writes.filter((write) => !refused.includes(write)),
+        refused,
+        ...(restorePoint !== undefined ? { restorePoint } : {}),
+    };
+}
+//# sourceMappingURL=translate-apply.js.map

package/dist/lib/ai/translate-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-apply.js","sourceRoot":"","sources":["../../../src/lib/ai/translate-apply.ts"],"names":[],"mappings":"AA4DA,MAAM,OAAO,GAAG,CAAC,IAA2B,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;AAErF,2GAA2G;AAC3G,SAAS,SAAS,CAAC,KAAoB;IACrC,OAAO,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAoE,EACpE,IAAwB,EACxB,MAA4B;IAE5B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IACrF,IAAI,YAAgC,CAAA;IACpC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAA;QACtC,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,OAAO,EAAE,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAC7D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC3H,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/F,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjE,OAAO;QACP,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAA;AACH,CAAC","sourcesContent":["import type { DocumentPatch, ValuePath } from '@elytracms/core/cms-core'\nimport type { TranslateDocumentResult, TranslateWrite } from './translate-document'\n\n/**\n * EC-752 — how a translation run's writes land, in order: the pure core of the \"Translate\n * document\" dialog's apply (the dialog wires it to the session's commit queue and the\n * `documents.snapshot` operation), so the order is pinned by a test, not by a component.\n *\n * Re-translate everything REPLACES values someone made, and the draft records no history of\n * its own (versions are recorded on publish, snapshot and restore only), so an unpublished\n * manual translation it replaced was unrecoverable — the dialog used to snapshot only AFTER\n * its commit, a restore point holding the post-write state. Now:\n *\n *  1. `retranslate-all` with anything to write: a labelled snapshot of the stored draft\n *     FIRST — the restore point Versions / Compare's scoped restore brings a field back\n *     from. If it cannot be recorded, nothing is written (`snapshot-failed`): a\n *     re-translation never replaces what it could not save.\n *  2. The patches, through the caller's commit (the session's queue, at the revision the\n *     draft was authored on — a position a colleague changed meanwhile is refused there).\n *  3. The AI-provenance snapshot (best-effort, as before — the draft already landed).\n *\n * `fill-empty` is unchanged: it fills only values that followed the base, so it replaces\n * nothing and takes no restore point.\n */\n\n/** What the caller's commit reports — structurally the session's `CommitOutcome`. */\nexport type TranslateCommitOutcome =\n  | { readonly status: 'applied' }\n  | { readonly status: 'refused'; readonly conflicts: readonly { readonly path: ValuePath }[] }\n  | { readonly status: 'failed' }\n\nexport interface TranslateApplyDeps {\n  /** Persist the run's patches; `undefined` when the session applied them locally (a fixture session). */\n  commit(patches: readonly DocumentPatch[]): Promise<TranslateCommitOutcome | undefined>\n  /** Record the current stored draft as a version (`documents.snapshot`). */\n  snapshot(options: { readonly label: string; readonly origin?: string }): Promise<{ readonly version: number }>\n}\n\nexport interface TranslateApplyLabels {\n  /** The restore point's label (taken before a re-translation writes). */\n  readonly restorePoint: string\n  /** The provenance snapshot's label (taken after the write). */\n  readonly provenance: string\n}\n\nexport type TranslateApplyOutcome =\n  | {\n      readonly status: 'applied'\n      /** The writes that landed — the run's writes minus the ones refused at their revision. */\n      readonly writes: readonly TranslateWrite[]\n      /** Writes refused because a colleague changed the position meanwhile (shown as conflicts there). */\n      readonly refused: readonly TranslateWrite[]\n      /** The version recorded before a re-translation wrote — what Versions restores from. */\n      readonly restorePoint?: number\n    }\n  /** `retranslate-all`: the restore point could not be recorded, so nothing was written. */\n  | { readonly status: 'snapshot-failed' }\n  /** The commit failed (transport, authorization): reported by the session too. */\n  | { readonly status: 'failed' }\n\nconst pathKey = (path: ValuePath | undefined): string => JSON.stringify(path ?? null)\n\n/** The position a field write's patch addresses (`set` / `unset` — the only kinds a translation emits). */\nfunction patchPath(patch: DocumentPatch): ValuePath | undefined {\n  return 'path' in patch ? patch.path : undefined\n}\n\nexport async function applyTranslation(\n  result: Pick<TranslateDocumentResult, 'plan' | 'writes' | 'patches'>,\n  deps: TranslateApplyDeps,\n  labels: TranslateApplyLabels,\n): Promise<TranslateApplyOutcome> {\n  if (result.writes.length === 0) return { status: 'applied', writes: [], refused: [] }\n  let restorePoint: number | undefined\n  if (result.plan.mode === 'retranslate-all') {\n    try {\n      restorePoint = (await deps.snapshot({ label: labels.restorePoint })).version\n    } catch {\n      return { status: 'snapshot-failed' }\n    }\n  }\n  const outcome = await deps.commit(result.patches)\n  if (outcome?.status === 'failed') return { status: 'failed' }\n  const refusedAt = new Set(outcome?.status === 'refused' ? outcome.conflicts.map((conflict) => pathKey(conflict.path)) : [])\n  const refused = result.writes.filter((write) => refusedAt.has(pathKey(patchPath(write.patch))))\n  try {\n    await deps.snapshot({ label: labels.provenance, origin: 'assistant' })\n  } catch {\n    // ignore — provenance is additive\n  }\n  return {\n    status: 'applied',\n    writes: result.writes.filter((write) => !refused.includes(write)),\n    refused,\n    ...(restorePoint !== undefined ? { restorePoint } : {}),\n  }\n}\n"]}

package/dist/lib/ai/translate-document.d.ts

@@ -6,7 +6,10 @@ export declare const DEFAULT_TRANSLATE_BATCH_SIZE = 12;
 export declare const DEFAULT_TRANSLATE_CONCURRENCY = 6;
 /** The schema name the batch call carries — how a FakeProvider recognises a translate call. */
 export declare const TRANSLATE_SCHEMA_NAME = "translate_units";
-/** Fill only still-connected locale values (default), or re-translate every localized field. */
+/**
+ * Fill only still-connected locale values (default), or re-translate every localized field
+ * — replacing a value with its own translation, rebuilt from the base (EC-752).
+ */
 export type TranslateMode = 'fill-empty' | 'retranslate-all';
 export interface TranslateDocumentInput {
     provider: AiProvider;
@@ -18,7 +21,12 @@ export interface TranslateDocumentInput {
     targetLocales?: readonly Locale[];
     /** Assembled project knowledge (glossary / voice) sent as context with every batch. */
     knowledge?: ResolvedKnowledge;
-    /** `fill-empty` (default) or `retranslate-all` (overwrites diverged values — gated in UI). */
+    /**
+     * `fill-empty` (default) or `retranslate-all` — which REPLACES a value with its own
+     * translation, whole or not at all, never a slug the editor set (EC-752). The studio runs
+     * it only behind a confirm listing {@link planTranslation}'s replacements, after a version
+     * snapshot of the draft.
+     */
     mode?: TranslateMode;
     batchSize?: number;
     concurrency?: number;
@@ -52,17 +60,26 @@ export interface TranslateProgress {
 }
 /** Why a text position was not translated. */
 export type TranslateSkipReason = 
-/** The stored value at the position is not readable as its type (e.g. a pre-convergence rich text). */
+/**
+ * The stored value at the position is not readable as its type (e.g. a pre-convergence rich
+ * text) — or (EC-752) it is a value the traversal cannot read at all (`OpaquePosition`: a
+ * holder stored in a shape its declaration no longer reads) that may hold text.
+ */
 'unreadable'
 /** The provider returned no (or empty) text for the unit. */
  | 'not-returned'
-/** The translation did not keep the formatting / link / embed tokens; the original was kept. */
+/**
+ * The translation did not keep the formatting / link / embed tokens: `fill-empty` keeps
+ * the source's block in the fill; `retranslate-all` leaves the whole target value as it was.
+ */
  | 'structure-changed'
 /**
  * EC-738: the bucket's locked content (`form.readOnly` / `ai.exclude`) differs in shape
  * from the source's — writing the translation would lose a locked value the target holds or
  * add one it does not (a repeater with more or fewer items, a composition with other
- * nodes). The whole bucket was left as it is: only code, a seed or an import changes it.
+ * nodes) — or (EC-748) either side stores it in a shape the declaration no longer reads.
+ * The whole bucket was left as it is: only code, a seed, an import or a save in the editor
+ * changes it.
  */
  | 'locked';
 /**
@@ -82,9 +99,71 @@ export interface TranslateSkip {
     };
     reason: TranslateSkipReason;
 }
+/** One `(field, locale)` value — the unit a translation writes, plans and reports (EC-752). */
+export interface TranslateBucket {
+    readonly field: string;
+    readonly locale: Locale;
+}
+/**
+ * What a planned bucket is (EC-752): `fill` — the target FOLLOWS the base (EC-318 connected)
+ * and gets its own translation; `replace` — the target holds its own value (an earlier
+ * translation, an editor's edit), which a re-translation rebuilds from the base — its text
+ * translated, every other value (a number, an image, a select) the base's, its locked
+ * positions kept (EC-738). `replace` exists only in `retranslate-all`.
+ */
+export type TranslateBucketKind = 'fill' | 'replace';
+export interface TranslatePlanBucket extends TranslateBucket {
+    readonly kind: TranslateBucketKind;
+}
+/**
+ * EC-752 — what a run will do, judged BEFORE any provider call: the eligibility, the locked
+ * judgement (EC-738), the units and the unreadable positions. ONE judge
+ * ({@link planTranslation}) gives both the studio's confirm and the run's input, so the list
+ * an editor confirms is the list the run works from.
+ *
+ * It is an UPPER bound ("up to"): what is known only after the provider answered — a unit
+ * not returned, a block whose tokens did not survive, a cancel, the introduced-errors gate
+ * refusing the run, a colleague's write refused at its revision — can only take a bucket
+ * away. {@link TranslateDocumentResult.writes} says what was written.
+ */
+export interface TranslatePlan {
+    readonly mode: TranslateMode;
+    readonly base: Locale;
+    /** Every configured locale but the base (or the caller's `targetLocales`). */
+    readonly targets: readonly Locale[];
+    /** The buckets the run writes when every unit lands — walk order (field, then locale). */
+    readonly buckets: readonly TranslatePlanBucket[];
+    /**
+     * What the run will NOT translate, known now: a bucket left as it is for its locked
+     * content (`locked`), an unreadable position (`unreadable` — in `retranslate-all` its whole
+     * bucket is left as it was, so it is not in {@link buckets}).
+     */
+    readonly skipped: readonly TranslateSkip[];
+    /** Translatable units — the run's {@link TranslateDocumentResult.total}. */
+    readonly total: number;
+}
+/** What {@link planTranslation} reads — the run's own inputs, minus the provider. */
+export type TranslatePlanInput = Pick<TranslateDocumentInput, 'collection' | 'document' | 'localeConfig' | 'targetLocales' | 'mode' | 'validateOptions'>;
+/**
+ * One bucket this run WROTE (EC-752): a planned `fill` / `replace` whose every unit landed
+ * (`fill-empty`: at least one), or a `slug` derived from the translated source (only where
+ * the target's slug followed the base). `patch` is the one the caller persists
+ * ({@link TranslateDocumentResult.patches}, same order).
+ */
+export interface TranslateWrite extends TranslateBucket {
+    readonly kind: TranslateBucketKind | 'slug';
+    readonly patch: DocumentPatch;
+}
 export interface TranslateDocumentResult {
-    /** The new draft with the translations filled in (base + connected locale values). */
+    /** The new draft with the translations in. */
     document: CmsDocument;
+    /** EC-752 — the pre-provider plan this run executed ({@link planTranslation} on its input). */
+    plan: TranslatePlan;
+    /**
+     * EC-752 — what this run wrote, one entry per bucket, in {@link patches}' order: compare
+     * with {@link plan} for what was planned but not written.
+     */
+    writes: readonly TranslateWrite[];
     /**
      * EC-595 A2 — the positions this run wrote, as patches (one per `(field, locale)`
      * bucket it filled — "localized fields patch per bucket"): what the caller persists,
@@ -101,7 +180,7 @@ export interface TranslateDocumentResult {
     changed: boolean;
     /** Translatable units filled per target locale. */
     perLocale: Record<Locale, number>;
-    /** Slug fields derived per target locale (not model-translated). */
+    /** Slug fields derived (not model-translated) — the `slug` entries of {@link writes}. */
     slugsDerived: number;
     /** Every text position the run could not translate (EC-593) — empty when all landed. */
     skipped: readonly TranslateSkip[];
@@ -125,4 +204,12 @@ export interface TranslateDocumentResult {
     /** Surviving non-error findings on the produced draft — carried onto a proposal. */
     issues: readonly CmsValidationIssue[];
 }
+/**
+ * EC-752 — THE pre-provider judge: which field × locale values a translation of `input`
+ * writes when every unit lands (`fill` / `replace`), and what it already knows it will not
+ * translate (`locked`, `unreadable`). Pure: no provider, no store, no clock. The studio's
+ * confirm lists it; {@link translateDocument} runs exactly it — one judge, never a second
+ * count. See {@link TranslatePlan} for why it is an upper bound.
+ */
+export declare function planTranslation(input: TranslatePlanInput): TranslatePlan;
 export declare function translateDocument(input: TranslateDocumentInput): Promise<TranslateDocumentResult>;