@elytracms/studio 0.0.80 → 0.0.82

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

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { createCollectionRegistry } from '@elytracms/core/cms-core';
 import { Check, Languages, Loader2, X } from 'lucide-react';
 import { Badge, Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Row, Stack, Text, } from '@elytracms/studio/ui';
 import { translate } from '@elytracms/studio/lib/i18n';
@@ -7,11 +8,26 @@ import { localeChipLabel } from '@elytracms/studio/lib/locale';
 import { getStudioOperations } from '@elytracms/studio/lib/operations';
 import { resolveDeploymentAi } from '@elytracms/studio/lib/workspace';
 import { resolveAiConfig, resolveKnowledge, translateDocument } from '@elytracms/studio/lib/ai';
+import { cmsValidationIssueMessage } from '@elytracms/studio/lib/persona/labels';
+import { useCms } from '../cms/cms-store.js';
 export function TranslateDocumentDialog({ projectId, collection, docRef, document, localeConfig, onApplied, open, onOpenChange, }) {
     const [phase, setPhase] = useState('confirm');
     const [progress, setProgress] = useState(null);
     const [summary, setSummary] = useState(null);
+    /**
+     * EC-497 — why the refusal was blocked, when the gate refused. Reuses the
+     * EC-473 `ai.error.applyInvalid` copy ("the proposal no longer fits the current
+     * document: …"), which is exactly this situation: no new catalog string, and the
+     * editor is told WHICH rules the translation would have broken rather than a bare
+     * "failed".
+     */
+    const [refusal, setRefusal] = useState(null);
     const abortRef = useRef(null);
+    const cms = useCms();
+    // The session registry the produced draft is judged against. Built here rather
+    // than added to the CMS store's public surface for one consumer; the memo means
+    // once per open, not once per render.
+    const registry = useMemo(() => createCollectionRegistry(cms.collections), [cms.collections]);
     useEffect(() => () => abortRef.current?.abort(), []);
     const base = localeConfig.default;
     const targets = localeConfig.locales.filter((l) => l !== base);
@@ -28,6 +44,7 @@ export function TranslateDocumentDialog({ projectId, collection, docRef, documen
         }
         const controller = new AbortController();
         abortRef.current = controller;
+        setRefusal(null);
         setPhase('running');
         setProgress({ completed: 0, total: 0 });
         try {
@@ -40,7 +57,25 @@ export function TranslateDocumentDialog({ projectId, collection, docRef, documen
                 knowledge,
                 signal: controller.signal,
                 onProgress: setProgress,
+                // EC-497 — this action used to hand `translateDocument`'s output STRAIGHT to
+                // `documents.upsert` with nothing in between: no gate, no proposal card, no
+                // re-validation, so model-generated content reached the document completely
+                // unvalidated while the chat path validated twice. It now validates with the
+                // session's canonical bag (`cms.validateOptions`) — the editor's own rules —
+                // and refuses below on what the translation INTRODUCED.
+                registry,
+                validateOptions: cms.validateOptions,
             });
+            if (result.introducedErrors.length > 0) {
+                setRefusal(translate('ai.error.applyInvalid', {
+                    issues: result.introducedErrors
+                        .slice(0, 3)
+                        .map((issue) => cmsValidationIssueMessage(issue))
+                        .join('; '),
+                }));
+                setPhase('error');
+                return;
+            }
             if (result.translated > 0 || result.slugsDerived > 0) {
                 const { operations } = await getStudioOperations();
                 const upserted = await operations.documents.upsert({ projectId, document: result.document });
@@ -77,7 +112,7 @@ export function TranslateDocumentDialog({ projectId, collection, docRef, documen
         finally {
             abortRef.current = null;
         }
-    }, [projectId, collection, document, localeConfig, docRef, onApplied]);
+    }, [projectId, collection, document, localeConfig, docRef, onApplied, registry, cms.validateOptions]);
     const close = () => {
         if (phase === 'running')
             return; // never close mid-run — Cancel aborts instead
@@ -92,6 +127,6 @@ export function TranslateDocumentDialog({ projectId, collection, docRef, documen
     };
     return (_jsx(Dialog, { open: open, onOpenChange: (next) => (!next ? close() : undefined), children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: _jsxs(Row, { gap: "2", align: "center", children: [_jsx(Languages, { className: "size-4" }), " ", translate('ai.translate.dialogTitle')] }) }), _jsx(DialogDescription, { children: translate('ai.translate.dialogDescription', { base: localeChipLabel(base) }) })] }), phase === 'confirm' ? (_jsxs(Stack, { gap: "4", className: "py-2", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Text, { size: "xs", weight: "medium", tone: "muted", children: translate('ai.translate.targetsLabel') }), _jsx(Row, { gap: "1", wrap: true, children: targets.map((l) => (_jsx(Badge, { variant: "outline", children: localeChipLabel(l) }, l))) })] }), _jsxs(Stack, { gap: "1", children: [_jsx(Text, { size: "xs", weight: "medium", tone: "muted", children: translate('ai.translate.scopeLabel') }), _jsxs(Row, { gap: "2", align: "center", children: [_jsx(Badge, { variant: "default", children: translate('ai.translate.fillMissing') }), _jsx(Button, { size: "sm", variant: "ghost", disabled: true, title: translate('ai.translate.retranslateSoon'), children: translate('ai.translate.retranslateAll') }), _jsx(Text, { size: "xs", tone: "muted", children: translate('ai.translate.retranslateSoon') })] })] })] })) : null, phase === 'running' ? (_jsxs(Stack, { gap: "3", align: "center", className: "py-6", children: [_jsx(Loader2, { className: "size-6 animate-spin text-primary" }), _jsx(Text, { size: "sm", tone: "muted", "data-testid": "translate-progress", children: progress && progress.total > 0
                                 ? translate('ai.translate.progress', { completed: progress.completed, total: progress.total })
-                                : translate('ai.translate.preparing') }), progress && progress.total > 0 ? (_jsx("div", { className: "h-1.5 w-56 overflow-hidden rounded-full bg-muted", children: _jsx("div", { className: "h-full rounded-full bg-primary transition-all", style: { width: `${Math.round((progress.completed / progress.total) * 100)}%` } }) })) : null] })) : null, phase === 'done' && summary ? (_jsxs(Stack, { gap: "2", align: "center", className: "py-6", children: [_jsx(Check, { className: "size-6 text-success" }), _jsx(Text, { size: "sm", tone: "muted", className: "text-center", "data-testid": "translate-summary", children: doneMessage(summary) })] })) : null, phase === 'error' ? (_jsxs(Stack, { gap: "2", align: "center", className: "py-6", children: [_jsx(X, { className: "size-6 text-destructive" }), _jsx(Text, { size: "sm", tone: "muted", children: translate('ai.translate.failed') })] })) : null, _jsx(DialogFooter, { className: "mt-2", children: phase === 'confirm' ? (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: close, children: translate('common.cancel') }), _jsxs(Button, { size: "sm", onClick: () => void run(), "data-testid": "translate-confirm", children: [_jsx(Languages, {}), " ", translate('ai.translate.confirm')] })] })) : phase === 'running' ? (_jsx(Button, { variant: "outline", size: "sm", onClick: () => abortRef.current?.abort(), "data-testid": "translate-cancel", children: translate('common.cancel') })) : (_jsx(Button, { size: "sm", onClick: close, "data-testid": "translate-close", children: translate('ai.translate.close') })) })] }) }));
+                                : translate('ai.translate.preparing') }), progress && progress.total > 0 ? (_jsx("div", { className: "h-1.5 w-56 overflow-hidden rounded-full bg-muted", children: _jsx("div", { className: "h-full rounded-full bg-primary transition-all", style: { width: `${Math.round((progress.completed / progress.total) * 100)}%` } }) })) : null] })) : null, phase === 'done' && summary ? (_jsxs(Stack, { gap: "2", align: "center", className: "py-6", children: [_jsx(Check, { className: "size-6 text-success" }), _jsx(Text, { size: "sm", tone: "muted", className: "text-center", "data-testid": "translate-summary", children: doneMessage(summary) })] })) : null, phase === 'error' ? (_jsxs(Stack, { gap: "2", align: "center", className: "py-6", children: [_jsx(X, { className: "size-6 text-destructive" }), _jsx(Text, { size: "sm", tone: "muted", className: "text-center", "data-testid": "translate-error", children: refusal ?? translate('ai.translate.failed') })] })) : null, _jsx(DialogFooter, { className: "mt-2", children: phase === 'confirm' ? (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: close, children: translate('common.cancel') }), _jsxs(Button, { size: "sm", onClick: () => void run(), "data-testid": "translate-confirm", children: [_jsx(Languages, {}), " ", translate('ai.translate.confirm')] })] })) : phase === 'running' ? (_jsx(Button, { variant: "outline", size: "sm", onClick: () => abortRef.current?.abort(), "data-testid": "translate-cancel", children: translate('common.cancel') })) : (_jsx(Button, { size: "sm", onClick: close, "data-testid": "translate-close", children: translate('ai.translate.close') })) })] }) }));
 }
 //# sourceMappingURL=translate-document-dialog.js.map

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, useRef, useState } from 'react'\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 '@elytracms/studio/lib/i18n'\nimport { localeChipLabel } from '@elytracms/studio/lib/locale'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport { resolveDeploymentAi } from '@elytracms/studio/lib/workspace'\nimport { resolveAiConfig, resolveKnowledge, translateDocument } from '@elytracms/studio/lib/ai'\nimport type { TranslateProgress } from '@elytracms/studio/lib/ai'\nimport type { TranslateDocumentActionProps } from './translate-document-action'\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}\n\nexport function TranslateDocumentDialog({\n  projectId,\n  collection,\n  docRef,\n  document,\n  localeConfig,\n  onApplied,\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  const abortRef = useRef<AbortController | null>(null)\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    setPhase('running')\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      })\n      if (result.translated > 0 || result.slugsDerived > 0) {\n        const { operations } = await getStudioOperations()\n        const upserted = await operations.documents.upsert({ projectId, document: result.document })\n        if (!upserted.ok) {\n          setPhase('error')\n          return\n        }\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        onApplied(result.document)\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,\n      })\n      setPhase('done')\n    } catch {\n      setPhase('error')\n    } finally {\n      abortRef.current = null\n    }\n  }, [projectId, collection, document, localeConfig, docRef, onApplied])\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          </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\">\n              {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 { 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 '@elytracms/studio/lib/i18n'\nimport { localeChipLabel } from '@elytracms/studio/lib/locale'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport { resolveDeploymentAi } from '@elytracms/studio/lib/workspace'\nimport { resolveAiConfig, resolveKnowledge, translateDocument } from '@elytracms/studio/lib/ai'\nimport type { TranslateProgress } from '@elytracms/studio/lib/ai'\nimport { cmsValidationIssueMessage } from '@elytracms/studio/lib/persona/labels'\nimport { useCms } from '../cms/cms-store'\nimport type { TranslateDocumentActionProps } from './translate-document-action'\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}\n\nexport function TranslateDocumentDialog({\n  projectId,\n  collection,\n  docRef,\n  document,\n  localeConfig,\n  onApplied,\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    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        const { operations } = await getStudioOperations()\n        const upserted = await operations.documents.upsert({ projectId, document: result.document })\n        if (!upserted.ok) {\n          setPhase('error')\n          return\n        }\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        onApplied(result.document)\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,\n      })\n      setPhase('done')\n    } catch {\n      setPhase('error')\n    } finally {\n      abortRef.current = null\n    }\n  }, [projectId, collection, document, localeConfig, docRef, onApplied, registry, cms.validateOptions])\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          </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"]}

package/dist/components/app-views/default-modules.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 import type { LucideIcon } from 'lucide-react';
 import type { CmsDocument, CollectionDef, CollectionFieldOverride, CollectionFormMeta, LocaleConfig } from '@elytracms/core/cms-core';
-import type { Project, SectionId } from '@elytracms/core/studio-core';
+import type { CustomizationIssue, Project, SectionId } from '@elytracms/core/studio-core';
 import type { InstantiatedKit } from '@elytracms/core/starter-kits';
 import type { HydratedCms } from '@elytracms/studio/lib/operations';
 import { type AppViewContext, type AppViewDeepLink, type AppViewModule, type NavPermission, type SidebarViewNode } from './module.js';
@@ -28,6 +28,11 @@ export interface CmsViewConfig {
      * Scope the rail auto-expansion (EC-293) to these collection ids, in order. The
      * parent expands into one focused-lens child per id; the parent index shows the
      * same subset. Omitted → every collection. Ignored for a single-collection lens.
+     *
+     * A ONE-ITEM array is legal and degrades to a working (if redundant) parent+child
+     * pair — the parent takes the `cms-group:<id>` id so it cannot collide with its own
+     * child (EC-468). For a single collection with no group heading, prefer the
+     * {@link CmsViewConfig.collection} leaf form.
      */
     collections?: readonly string[];
     /** Single-collection lens: a LEAF rail item that opens straight into this collection. */
@@ -103,12 +108,46 @@ export interface CustomViewConfig {
     /** OPTIONAL, default-open nav-permission predicate (EC-240 / AD-18). See {@link BuiltinViewConfig.visible}. */
     visible?: NavPermission;
 }
+/**
+ * Derive a stable, deterministic id from the CMS focus (overridable via `config.id`).
+ *
+ * The id is the route segment, the rail's active-state key AND the override key
+ * (EC-311), so it must be injective: two focuses deriving one id means
+ * `resolveOverrides` drops the later view. The derived shapes:
+ *
+ * | focus                        | id                        |
+ * | ---------------------------- | ------------------------- |
+ * | none                         | `cms`                     |
+ * | `collection: 'page'` (leaf)  | `cms:page`                |
+ * | `collections: ['a','b']`     | `cms:a-b`                 |
+ * | `collections: ['page']`      | `cms-group:page`          |
+ *
+ * EC-468 — why the one-item group is its own namespace: `cms:${join(L)}` of a
+ * single-element list IS that element, so the auto-generated PARENT took the very id
+ * its own auto-expanded child derives (`cmsCollectionLeaf` → `cmsView({ collection })`).
+ * Both landed in the one flat override list `resolveSidebar` feeds `resolveOverrides`,
+ * so the child was dropped with a `duplicate-override-id` error and the parent rendered
+ * childless — a forced collision no config could avoid. Nothing else changes: the leaf
+ * and the multi-collection join keep their exact ids (consumer rails route on them).
+ *
+ * EC-477 — `-` is a SEPARATOR here, and a collection id may legally contain one, so a
+ * collection literally named `a-b` derives the same `cms:a-b` as a `['a','b']` group.
+ * That ambiguity is NOT closed by constraining collection ids (a permanent, repo-wide
+ * naming ban to fix a two-config coincidence, when hyphenated ids are ordinary — see
+ * the task's Done); it is DETECTED where both facts are known, by
+ * {@link checkSidebarIdKeyspace}, which raises a `derived-id-collision` the moment a
+ * group's join equals a real collection id. The escape hatch is unchanged: an explicit
+ * `nav.cms({ id })` always wins, and the derivation below is untouched — consumer rails
+ * route on these ids.
+ */
+export declare function cmsViewId(config: CmsViewConfig): string;
 /**
  * Build a CMS view — the default `cms` view, or a focused instance. Every instance
  * shares one surface ({@link CmsScreen}); `collections` narrows the sidebar + index
  * to a subset, `collection` is a single-collection lens that opens straight into
  * that collection's list. The id is derived from the focus (deterministic, stable
- * across rail reorders) unless `id` is given — so two focused views never collide.
+ * across rail reorders) unless `id` is given — see {@link cmsViewId} for the derived
+ * shapes and the one keyspace ambiguity that survives.
  */
 export declare function cmsView(config?: CmsViewConfig): AppViewModule;
 /** The components registry browser view. */
@@ -155,7 +194,15 @@ export declare function extensionsView(config?: BuiltinViewConfig): AppViewModul
 export declare function settingsView(config?: BuiltinViewConfig): AppViewModule;
 /** The legacy `builder` redirect — a hidden, routable view (so `/builder?page=` still lands). */
 export declare function builderView(): AppViewModule;
-/** Build a fully custom view (the `nav.view(...)` escape hatch). */
+/**
+ * Build a fully custom view (the `nav.view(...)` escape hatch).
+ *
+ * With no `id` the id is a SLUG of the label, and that slug carries a
+ * {@link DerivedViewId} marker (EC-476): a label is a display string a developer picks
+ * freely, so `label: 'CMS'` deriving `cms` is a coincidence, not a request to replace
+ * the built-in CMS surface. {@link checkSidebarIdKeyspace} refuses the takeover and
+ * says so; an explicit `id` carries no marker and keeps the documented replacement.
+ */
 export declare function customView(config: CustomViewConfig): AppViewModule;
 /**
  * The studio's built-in views in canonical rail order (components · CMS · routes ·
@@ -165,11 +212,57 @@ export declare function customView(config: CustomViewConfig): AppViewModule;
  * when a consumer's rail omits one.
  */
 export declare const DEFAULT_VIEWS: readonly AppViewModule[];
+/**
+ * Every id the engine already owns — the replacement targets of the sidebar seam,
+ * INCLUDING the hidden `builder` redirect (it is in the keyspace even though the stock
+ * rail does not list it, so a derived id can swallow it just the same).
+ */
+export declare const BUILTIN_VIEW_IDS: ReadonlySet<string>;
+/** The outcome of the keyspace check: the entries that may still act as overrides, plus the findings. */
+export interface SidebarIdKeyspace {
+    /**
+     * The views to resolve as overrides — an ACCIDENTAL built-in takeover removed, so the
+     * engine keeps its own block (the EC-236 contract for a rejected entry). Everything
+     * else passes through untouched, including the merely-ambiguous EC-477 case.
+     */
+    views: AppViewModule[];
+    /** What was found — visible at the rail foot, never silent. */
+    issues: CustomizationIssue[];
+}
+/**
+ * EC-476/477 — guard the sidebar id keyspace against ids that were DERIVED rather than
+ * declared, and landed somewhere that already means something.
+ *
+ * The seam's replacement rule is id equality (`resolveOverrides`: an entry whose id is a
+ * default's id replaces it). That is exactly right for an id the developer TYPED, and
+ * exactly wrong for one a builder computed — and the generic core cannot tell them
+ * apart, because by the time an entry reaches it, an id is just a string. So the rule
+ * lives HERE, next to the derivations that produce it ({@link slugify},
+ * {@link cmsViewId}) and next to {@link DEFAULT_VIEWS}, the set it has to protect.
+ *
+ * Two derived shapes, two different remedies — because the cost of being wrong differs:
+ *
+ * - **A slugged LABEL landing on a built-in id (EC-476) is REJECTED** (`error`). Losing
+ *   a whole built-in surface — the CMS, Assets, the users roster — to a coincidence of
+ *   spelling is far worse than one custom view not appearing, and the developer's fix is
+ *   a one-line explicit `id`. The built-in is kept, so nothing disappears.
+ * - **A collection JOIN equal to a real collection id (EC-477) is KEPT** (`warning`).
+ *   Nothing here is a takeover: the group's id is legitimate, it is merely no longer
+ *   unique to it, so dropping the view would destroy a rail item the developer
+ *   explicitly declared in order to report a naming clash. Reporting is the whole fix.
+ *
+ * Pure and deterministic — the house "extract the core, test the core" shape.
+ * `builtinIds` and `collections` are parameters so the rule is testable against a
+ * synthetic keyspace, not just the live one.
+ */
+export declare function checkSidebarIdKeyspace(views: readonly AppViewModule[], collections?: readonly CollectionDef[], builtinIds?: ReadonlySet<string>): SidebarIdKeyspace;
 export declare const nav: {
     /**
      * The CMS view. `nav.cms()` / `nav.cms({ collections })` is a PARENT that nests its
      * collections in the rail (each a focused `cms:<id>` lens); `nav.cms({ collection })`
      * is a single-collection LEAF; `nav.cms({ children })` supplies explicit children.
+     * A one-item `collections` group is a parent whose id is `cms-group:<id>`, distinct
+     * from its single child by construction (EC-468 — see {@link cmsViewId}).
      */
     readonly cms: (config?: CmsViewConfig) => SidebarViewNode;
     /** The component registry browser. */
@@ -193,46 +286,44 @@ export declare const nav: {
     readonly separator: () => import("./module.js").SidebarSeparatorNode;
 };
 /**
- * The CMS schema source for a project mount (bug fix, playground-collections):
- * a hydrated session wins (Convex), then a kit's imported schema (EC-119), then —
- * in playground mode only — the active project's config-declared collections
- * (AD-11, `resolveDeploymentCollections`). Without this last fallback, a non-kit
- * playground project has no hydrated session (`null`, by design — see
- * `project-session.tsx`) and no kit, so `CmsProvider` fell through to the core's
- * hardcoded `sampleFilterableCollections` fixture instead of the project's own
- * on-disk schema. Convex mode's first-run `null` is untouched — it still seeds
- * from the fixture there, as before. `playground` defaults to the live
- * {@link isPlaygroundMode} but is overridable so this stays unit testable
- * without stubbing the env (same seam as `resolveBackendConfig`).
- */
-export declare function resolveCmsInitialCollections(cms: HydratedCms | null, kit: InstantiatedKit | undefined, playground?: boolean): CollectionDef[] | undefined;
-/**
- * The CMS documents source for a project mount (EC-424) — the document-side
- * twin of {@link resolveCmsInitialCollections}, same ladder: a hydrated session
- * wins (Convex), then a kit's imported documents, then — in playground mode
- * only, and only when a config project actually resolved collections — the
- * engine's own `sampleDocuments` fixture RECONCILED against them.
+ * The CMS schema source for a project mount: a hydrated session wins (Convex),
+ * then a kit's imported schema (EC-119), then the active project's
+ * config-declared collections (AD-11, `resolveDeploymentCollections`).
+ *
+ * EC-479 — every rung is the PROJECT's own schema and there is no rung after
+ * them. The config rung used to be gated on playground mode, because outside it
+ * the `undefined` return let `CmsProvider` fall through to `cms-core`'s
+ * `sampleFilterableCollections` fixture — the engine's demo schema, shown as the
+ * project's, offering `filterable` fields the project's real backend would
+ * reject. With that fallback retired the gate has nothing left to protect: the
+ * Convex adapter is itself constructed with `resolveDeploymentCollections()`
+ * (`lib/persistence/index.ts`), so config collections are what connected mode
+ * serves too. Dropping it also DISSOLVES the EC-467 two-source divergence — the
+ * section rail reads `resolveDeploymentCollections()` directly, and now so does
+ * the store's last rung, so the two can no longer disagree.
+ */
+export declare function resolveCmsInitialCollections(cms: HydratedCms | null, kit: InstantiatedKit | undefined): CollectionDef[] | undefined;
+/**
+ * The CMS documents source for a project mount — the document-side twin of
+ * {@link resolveCmsInitialCollections}: a hydrated session wins (Convex), then a
+ * kit's imported documents, then **nothing**.
  *
- * Without this, a config project whose OWN schema diverges from the shared
- * fixture's localization (e.g. this repo's demo declares `post.slug` localized,
- * EC-315, while the engine's `postCollection` fixture deliberately does not)
- * left `CmsProvider` falling straight through to the un-reconciled
- * `sampleDocuments` default — the CMS surfaces' `initialCollections` already
- * reflected the config schema (via the fallback above), but `initialDocuments`
- * did not, so every seeded post showed EC-390's shape-aware validation's
- * `plain-value` warning + `missing-localized-value` error, standing noise a
- * project never actually wrote.
+ * EC-479 — the third rung used to be the engine's own `sampleDocuments` fixture,
+ * reconciled against the project's schema (EC-424). Reconciling it was already an
+ * admission that the content was foreign: EC-424 existed only because the demo
+ * declares `post.slug` localized while the shared fixture stores it plain, so the
+ * seeded posts carried standing validation noise no project had written. The
+ * honest fix is not a better reconciliation but no foreign content at all — a
+ * studio whose config did not arrive now shows an empty CMS and a visible issue
+ * at the rail, not six documents about Ada Lovelace wearing the project's schema.
  *
- * This is the STATIC-baseline twin of `reconcileSeedDocumentLocalization`
- * (`@elytracms/core/persistence`, wired into the seeded persistence adapter for
- * Convex-mode/delivery reads): no adapter round-trip, so the EC-138/EC-320
- * synchronous-first-render contract (`project-session.tsx`: "CMS surfaces keep
- * their fixture baseline") is untouched. `collections` defaults to the SAME
- * resolution `resolveCmsInitialCollections` returns, so the two stay in lockstep
- * by construction; only reconciles when that resolved to a non-empty config
- * schema (env-only playground, with nothing config-declared, is unaffected).
+ * The playground keeps its world through the ordinary path, not through here: its
+ * seeded in-memory adapter IS a persisted backend behind the operations seam
+ * (AD-17), so `CmsSessionGate` hydrates it and the first rung answers. What that
+ * adapter seeds is `persistence/seed.ts`'s business — EC-475 (project-defined seed
+ * content) owns it.
  */
-export declare function resolveCmsInitialDocuments(cms: HydratedCms | null, kit: InstantiatedKit | undefined, collections?: CollectionDef[] | undefined): CmsDocument[] | undefined;
+export declare function resolveCmsInitialDocuments(cms: HydratedCms | null, kit: InstantiatedKit | undefined): CmsDocument[] | undefined;
 /**
  * The CMS locale config for a project mount (EC-357 finding #3). Locales are
  * structure and structure is code: when the active `elytra.config.ts` project
@@ -240,10 +331,16 @@ export declare function resolveCmsInitialDocuments(cms: HydratedCms | null, kit:
  * wiring only applied the project's locale settings on a HYDRATED session, so a
  * playground boot — or a connected FIRST RUN with nothing persisted yet — fell
  * back to a kit's locales or the core's sample `en/de` fixture and the switcher
- * showed `EN·/DE` against a `locales: ['de']` config. Without a config project
- * (env-only wiring) the previous ladder is unchanged: hydrated project settings,
- * then the kit's locales, then the sample fixture (via `CmsProvider`'s default).
+ * showed `EN·/DE` against a `locales: ['de']` config.
+ *
+ * EC-479/EC-483 — the ladder is now TOTAL, and every rung is the project's own:
+ * config-declared locales, then (hydrated) its persisted settings, then a kit's,
+ * then its settings regardless. A `Project` only ever exists for a config-declared
+ * project (`studio-context.tsx`: `configProjects()`), so `project.settings` is
+ * config-derived too — which is what lets the CMS session require a locale instead
+ * of borrowing the engine's `en/de` fixture. The default locale is the literal
+ * storage key for every localized value, so a guessed one is a data migration.
  * `configLocales` is a parameter purely so the ladder is unit-testable (same seam
  * pattern as {@link resolveCmsInitialCollections}).
  */
-export declare function resolveCmsInitialLocaleConfig(cms: HydratedCms | null, kit: InstantiatedKit | undefined, project: Project, configLocales?: LocaleConfig | undefined): LocaleConfig | undefined;
+export declare function resolveCmsInitialLocaleConfig(cms: HydratedCms | null, kit: InstantiatedKit | undefined, project: Project, configLocales?: LocaleConfig | undefined): LocaleConfig;