@contentful/experience-design-system-cli 2.18.1-dev-build-2117d43.0 → 2.18.1-dev-build-55a7404.0

package/README.md

@@ -214,7 +214,7 @@ Pass `--select-prompt-path <path>` and/or `--generate-prompt-path <path>` to swa
 | `--host <url>`                    | `https://api.contentful.com`           | Override API base URL                                                                                        |
 | `--on-conflict <mode>`            | _(prompt via `<SaveConflictGate>`)_    | Headless conflict resolution when a file already exists at the save path: `overwrite`, `skip`, or `fail`. Bypasses the wizard's interactive save-conflict gate. Mutex with `--no-save`. |
 | `--print-prompt`                  | —                                      | Print the generate prompt to stdout and exit. Replaces the prompt-print semantics of `--dry-run`.            |
-| `--allow-deletions`               | off (non-destructive)                  | Allow the push to delete remote ComponentTypes/DesignTokens missing from the manifest. Default skips them instead of deleting. Forwarded to headless subprocess pushes and `--push-from-run`. |
+| `--allow-deletions`               | off (non-destructive)                  | Allow the push to delete remote ComponentTypes/DesignTokens missing from the manifest. Default skips them instead of deleting. Without this flag, preview responses suppress the removed-entity list and return a count instead; interactive confirm screens show an opt-out toggle (never opt-in) only when the flag is passed. Forwarded to headless subprocess pushes and `--push-from-run`. |
 | `--dry-run`                       | _(deprecated)_                         | Deprecated alias for `--print-prompt`. Emits a stderr deprecation notice; prompt-print semantics will be removed in a future release. |
 
 ### Run-picker at wizard start

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.18.1-dev-build-2117d43.0",
+  "version": "2.18.1-dev-build-55a7404.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/analyze/select/tui/App.js

@@ -80,7 +80,10 @@ export function App({ sessionId, artifactsRoot, reviewRoot }) {
             if (!manifest.componentsManifest)
                 manifest.componentsManifest = {};
             const client = new ImportApiClient({ cmaToken, spaceId, environmentId });
-            const preview = await client.previewImport(manifest);
+            // This preview is display-only (component-picker annotations); it never
+            // triggers an apply, so always request the full diff to keep the
+            // existing "removed" annotation working.
+            const preview = await client.previewImport(manifest, true);
             const annotations = {};
             for (const item of preview.components.new) {
                 const name = item.name ?? '';

package/dist/src/apply/api-client.d.ts

@@ -50,7 +50,7 @@ export declare class ImportApiClient {
     private headers;
     private requestWithRetry;
     validateToken(): Promise<void>;
-    previewImport(manifest: ManifestPayload): Promise<ServerPreviewResponse>;
+    previewImport(manifest: ManifestPayload, allowDeletions?: boolean): Promise<ServerPreviewResponse>;
     applyImport(manifest: ManifestPayload, options: {
         acknowledgeBreakingChanges: boolean;
         allowDeletions?: boolean;

package/dist/src/apply/api-client.js

@@ -268,19 +268,25 @@ export class ImportApiClient {
             throw new ApiError(`unexpected error validating token: ${res.status}`, res.status, await res.text());
         }
     }
-    async previewImport(manifest) {
+    async previewImport(manifest, allowDeletions = false) {
         const debug = getDebugLogger();
         const startedAt = Date.now();
         debug.event('apply', 'preview.request', {
             url: `${this.base()}/design_systems/imports/preview`,
             componentCount: manifest.components?.length ?? 0,
             tokenCount: manifest.designTokens?.length ?? 0,
+            allowDeletions,
         });
         const result = await this.requestWithRetry('preview', PREVIEW_ERROR_PREFIX, () => designSystemImportSourcelessPreview({
             baseUrl: this.host,
             headers: this.headers(),
             path: { spaceId: this.spaceId, environmentId: this.environmentId },
             body: manifest,
+            // The generated query type only declares `access_token` — the backend
+            // reads `allowDeletions` off the raw query string with no OpenAPI
+            // parameter declared for it. Cast narrowly here rather than widening
+            // the generated type for an undocumented param.
+            query: { allowDeletions: String(allowDeletions) },
             parseAs: 'json',
         }));
         if (!result.response.ok) {

package/dist/src/apply/command.js

@@ -504,7 +504,7 @@ export function registerApplyCommand(program) {
         const manifest = buildManifest(components, tokens);
         let preview;
         try {
-            preview = await client.previewImport(manifest);
+            preview = await client.previewImport(manifest, opts.allowDeletions === true);
         }
         catch (e) {
             if (e instanceof ApiError)
@@ -575,7 +575,7 @@ export function registerApplyCommand(program) {
             return;
         }
         await new Promise((resolvePromise) => {
-            const runApply = async (acknowledge) => {
+            const runApply = async (acknowledge, applyDeletions) => {
                 instance.rerender(createElement(ServerApplyProgress, {
                     spaceId,
                     environmentId,
@@ -585,7 +585,7 @@ export function registerApplyCommand(program) {
                 try {
                     operation = await client.applyImport(manifest, {
                         acknowledgeBreakingChanges: acknowledge,
-                        allowDeletions: opts.allowDeletions === true,
+                        allowDeletions: applyDeletions,
                     });
                 }
                 catch (e) {
@@ -635,8 +635,8 @@ export function registerApplyCommand(program) {
                 environmentId,
                 breakingWithImpact,
                 allowDeletions: opts.allowDeletions === true,
-                onConfirm: (acknowledge) => {
-                    void runApply(acknowledge);
+                onConfirm: (acknowledge, applyDeletions) => {
+                    void runApply(acknowledge, applyDeletions);
                 },
                 onCancel: () => {
                     process.exit(0);
@@ -680,7 +680,7 @@ export function registerApplyCommand(program) {
         const fullManifest = buildManifest(components, tokens);
         let preview;
         try {
-            preview = await client.previewImport(fullManifest);
+            preview = await client.previewImport(fullManifest, opts.allowDeletions === true);
         }
         catch (e) {
             if (e instanceof ApiError)

package/dist/src/apply/preview-utils.d.ts

@@ -1,12 +1,14 @@
 import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
 /**
  * True when a preview response describes zero server-side changes across
- * every diff bucket (components, tokens, taxonomies). Used by:
+ * every diff bucket (components, tokens, taxonomies) AND no suppressedDeletions.
+ * Used by:
  *   - `experiences apply` (CLI): short-circuit the confirm-and-push step.
  *   - `experiences import` wizard: block finalize when the resulting push
  *     would be a pure no-op (INTEG-4411 refined guard).
  *
  * A push that produces ANY entry in ANY bucket — including a rejection that
- * removes a server-side component — is NOT empty.
+ * removes a server-side component — is NOT empty. Similarly, a preview with
+ * ANY suppressedDeletions (when fetched with allowDeletions: false) is NOT empty.
  */
 export declare function isEmptyPreview(preview: ServerPreviewResponse): boolean;

package/dist/src/apply/preview-utils.js

@@ -1,15 +1,17 @@
 /**
  * True when a preview response describes zero server-side changes across
- * every diff bucket (components, tokens, taxonomies). Used by:
+ * every diff bucket (components, tokens, taxonomies) AND no suppressedDeletions.
+ * Used by:
  *   - `experiences apply` (CLI): short-circuit the confirm-and-push step.
  *   - `experiences import` wizard: block finalize when the resulting push
  *     would be a pure no-op (INTEG-4411 refined guard).
  *
  * A push that produces ANY entry in ANY bucket — including a rejection that
- * removes a server-side component — is NOT empty.
+ * removes a server-side component — is NOT empty. Similarly, a preview with
+ * ANY suppressedDeletions (when fetched with allowDeletions: false) is NOT empty.
  */
 export function isEmptyPreview(preview) {
-    const { components, tokens, taxonomies } = preview;
+    const { components, tokens, taxonomies, suppressedDeletions } = preview;
     return (components.new.length === 0 &&
         components.changed.length === 0 &&
         components.removed.length === 0 &&
@@ -18,5 +20,7 @@ export function isEmptyPreview(preview) {
         tokens.removed.length === 0 &&
         taxonomies.new.length === 0 &&
         taxonomies.changed.length === 0 &&
-        taxonomies.removed.length === 0);
+        taxonomies.removed.length === 0 &&
+        (suppressedDeletions?.components ?? 0) === 0 &&
+        (suppressedDeletions?.tokens ?? 0) === 0);
 }

package/dist/src/apply/tui/ServerApplyView.d.ts

@@ -5,11 +5,12 @@ interface ServerPreviewConfirmProps {
     spaceId: string;
     environmentId: string;
     breakingWithImpact: boolean;
+    /** The value the preview was actually fetched with. */
     allowDeletions: boolean;
-    onConfirm: (acknowledge: boolean) => void;
+    onConfirm: (acknowledge: boolean, allowDeletions: boolean) => void;
     onCancel: () => void;
 }
-export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
+export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions: fetchedAllowDeletions, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
 interface ServerPreviewAppProps {
     preview: ServerPreviewResponse;
     spaceId: string;

package/dist/src/apply/tui/ServerApplyView.js

@@ -1,17 +1,25 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
 import { Box, Text, useInput } from 'ink';
 import { ServerPreviewView } from './ServerPreviewView.js';
 import { buildPostPushUrl } from '../../lib/contentful-urls.js';
 import { formatEdsiError } from '../../lib/error-parser.js';
-export function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions, onConfirm, onCancel, }) {
+export function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions: fetchedAllowDeletions, onConfirm, onCancel, }) {
+    const [allowDeletions, setAllowDeletions] = useState(fetchedAllowDeletions);
+    const removedCount = preview.components.removed.length + preview.tokens.removed.length;
     useInput((input, key) => {
-        if (key.return)
-            onConfirm(breakingWithImpact);
+        if (key.return) {
+            onConfirm(breakingWithImpact, allowDeletions);
+            return;
+        }
+        if ((input === 'x' || input === 'X') && fetchedAllowDeletions && removedCount > 0) {
+            setAllowDeletions((prev) => !prev);
+            return;
+        }
         if (key.escape || input === 'q')
             onCancel();
     });
-    const removedCount = preview.components.removed.length + preview.tokens.removed.length;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId, allowDeletions: allowDeletions }), _jsxs(Box, { paddingX: 2, flexDirection: "column", children: [breakingWithImpact && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply."] })), allowDeletions && removedCount > 0 && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] })), _jsxs(Text, { children: [' ', "Press ", _jsx(Text, { bold: true, children: "Enter" }), " to apply, ", _jsx(Text, { bold: true, children: "Esc" }), " to cancel"] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId, allowDeletions: allowDeletions }), _jsxs(Box, { paddingX: 2, flexDirection: "column", children: [breakingWithImpact && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply."] })), allowDeletions && removedCount > 0 && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] })), fetchedAllowDeletions && removedCount > 0 && (_jsxs(Text, { dimColor: true, children: [' ', "[x] ", allowDeletions ? '[✓]' : '[ ]', " Also delete ", removedCount, " ", removedCount === 1 ? 'entity' : 'entities'] })), _jsxs(Text, { children: [' ', "Press ", _jsx(Text, { bold: true, children: "Enter" }), " to apply, ", _jsx(Text, { bold: true, children: "Esc" }), " to cancel"] })] })] }));
 }
 export function ServerPreviewApp({ preview, spaceId, environmentId, allowDeletions, }) {
     useInput((input, key) => {

package/dist/src/apply/tui/ServerPreviewView.js

@@ -19,5 +19,8 @@ export function ServerPreviewView({ preview, spaceId, environmentId, allowDeleti
     const totalTokens = tokens.new.length + tokens.changed.length + tokens.unchanged.length + tokens.removed.length;
     return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Preview \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), totalComponents > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Component Types (", totalComponents, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", components.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", components.changed.length, " to update"] }), _jsxs(Text, { color: allowDeletions ? 'red' : 'yellow', children: [' ', allowDeletions ? '✗' : '⊘', " ", components.removed.length, " to ", allowDeletions ? 'delete' : 'skip'] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", components.unchanged.length, " unchanged"] }), components.changed.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: item.hasPendingDraftChanges })] }), _jsx(BreakingBadge, { item: item })] }, i))), _jsx(Text, { children: " " })] })), totalTokens > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Design Tokens (", totalTokens, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", tokens.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", tokens.changed.length, " to update"] }), _jsxs(Text, { color: allowDeletions ? 'red' : 'yellow', children: [' ', allowDeletions ? '✗' : '⊘', " ", tokens.removed.length, " to ", allowDeletions ? 'delete' : 'skip'] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", tokens.unchanged.length, " unchanged"] }), tokens.changed
                         .filter((t) => t.hasPendingDraftChanges)
-                        .map((item, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: true })] }, i))), _jsx(Text, { children: " " })] })), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
+                        .map((item, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: true })] }, i))), _jsx(Text, { children: " " })] })), !allowDeletions &&
+                (preview.suppressedDeletions?.components ?? 0) + (preview.suppressedDeletions?.tokens ?? 0) > 0 && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: [' ', "\u2298 ", (preview.suppressedDeletions?.components ?? 0) + (preview.suppressedDeletions?.tokens ?? 0), ' ', (preview.suppressedDeletions?.components ?? 0) + (preview.suppressedDeletions?.tokens ?? 0) === 1
+                            ? 'entity'
+                            : 'entities', ' ', "skipped (rerun with --allow-deletions to remove them)"] }) })), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
 }

package/dist/src/import/tui/WizardApp.js

@@ -826,7 +826,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 tokens = await readTokensFromPath('tokens', tokensPath);
             }
             let manifest = buildManifest(components, tokens, { deleteAllComponents: allowEmptyDeleteAllRef.current });
-            let preview = await client.previewImport(manifest);
+            let preview = await client.previewImport(manifest, allowDeletions);
             if (extractSessionId) {
                 let needsRepreview = false;
                 const db = openPipelineDb();
@@ -848,7 +848,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                     if (needsRepreview) {
                         components = loadCDFComponents(db, extractSessionId);
                         manifest = buildManifest(components, tokens, { deleteAllComponents: allowEmptyDeleteAllRef.current });
-                        preview = await client.previewImport(manifest);
+                        preview = await client.previewImport(manifest, allowDeletions);
                     }
                 }
                 finally {
@@ -1433,7 +1433,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 return (_jsx(RunningStep, { stepNumber: stepNum, totalSteps: totalSteps, title: "Generating definitions", description: `${formatAcceptanceSummary({ accepted: state.acceptedCount, autoRejected: state.autoRejectedCount })} ${state.agent} is mapping your TypeScript types to Contentful's CDF format.${hasTokens ? ' Using your design tokens for prop resolution.' : ''}`, detail: progressDetail }));
             }
             case 'final-review': {
-                return (_jsx(FinalReviewHost, { extractSessionId: state.extractSessionId, generatedCount: state.generatedCount, autoAccept: autoAcceptScope, compositionMode: compositionMode, livePreview: livePreview, spaceId: state.spaceId, environmentId: state.environmentId, cmaToken: state.cmaToken, host: state.host, tokensPath: state.tokensPath, initialFinalizeError: state.finalizeErrorBanner, onFinalize: (accepted, rejected, unresolved) => {
+                return (_jsx(FinalReviewHost, { extractSessionId: state.extractSessionId, generatedCount: state.generatedCount, autoAccept: autoAcceptScope, compositionMode: compositionMode, livePreview: livePreview, spaceId: state.spaceId, environmentId: state.environmentId, cmaToken: state.cmaToken, host: state.host, tokensPath: state.tokensPath, initialFinalizeError: state.finalizeErrorBanner, allowDeletions: allowDeletions, onFinalize: (accepted, rejected, unresolved) => {
                         process.stderr.write(`Accepted: ${accepted}  Rejected: ${rejected}  Unresolved: ${unresolved}\n`);
                         let acceptedCount = accepted;
                         const detectAcceptedCycles = () => {
@@ -1601,7 +1601,7 @@ export function WizardApp({ initialSpaceId = '', initialEnvironmentId = 'master'
                 // present-but-empty (only $schema), so editing would dead-end on the
                 // "No generated definitions found" screen.
                 const editableComponentCount = Object.keys(state.manifest?.componentsManifest ?? {}).filter((k) => k !== '$schema').length;
-                return (_jsx(WizardPreviewStep, { preview: state.serverPreview, spaceId: state.spaceId, environmentId: state.environmentId, stepNumber: totalSteps, totalSteps: totalSteps, initialAllowDeletions: allowDeletions, onConfirm: (acknowledge, deleteMissing) => {
+                return (_jsx(WizardPreviewStep, { preview: state.serverPreview, spaceId: state.spaceId, environmentId: state.environmentId, stepNumber: totalSteps, totalSteps: totalSteps, allowDeletions: allowDeletions, onConfirm: (acknowledge, deleteMissing) => {
                         void runPush(state.manifest, state.spaceId, state.environmentId, state.cmaToken, state.host, acknowledge, deleteMissing, state.serverPreview);
                     }, ...(editableComponentCount > 0 ? { onEdit: () => void runEditFromPreview() } : {}), onSaveFiles: () => {
                         void startSaveFlow();

package/dist/src/import/tui/final-review-host.d.ts

@@ -14,5 +14,6 @@ export type FinalReviewHostProps = {
     host?: string;
     tokensPath?: string;
     initialFinalizeError?: string | null;
+    allowDeletions?: boolean;
 };
-export declare function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: FinalReviewHostProps): React.ReactElement;
+export declare function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: FinalReviewHostProps): React.ReactElement;

package/dist/src/import/tui/final-review-host.js

@@ -4,7 +4,7 @@ import { PALETTE } from '../../analyze/select/tui/theme.js';
 import React from 'react';
 import { GenerateReviewStep } from './steps/GenerateReviewStep.js';
 import { AtomicGenerateReviewStep } from './steps/AtomicGenerateReviewStep.js';
-export function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode = 'atomic', onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }) {
+export function FinalReviewHost({ extractSessionId, generatedCount, autoAccept, compositionMode = 'atomic', onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }) {
     if (!extractSessionId) {
         return (_jsx(Box, { paddingX: 2, paddingY: 1, children: _jsx(Text, { color: PALETTE.error, children: "Error: no session ID \u2014 cannot load generated definitions." }) }));
     }
@@ -15,7 +15,7 @@ export function FinalReviewHost({ extractSessionId, generatedCount, autoAccept,
     // passes projectSlotGraph to FieldEditor and never walks closures/cycles, so
     // slot-composition editing and every hierarchy affordance stay absent.
     const StepComponent = compositionMode === 'atomic' ? AtomicGenerateReviewStep : GenerateReviewStep;
-    return (_jsx(StepComponent, { extractSessionId: extractSessionId, onFinalize: onFinalize, onQuit: onQuit, livePreview: livePreview, spaceId: spaceId, environmentId: environmentId, cmaToken: cmaToken, host: host, tokensPath: tokensPath, initialFinalizeError: initialFinalizeError }));
+    return (_jsx(StepComponent, { extractSessionId: extractSessionId, onFinalize: onFinalize, onQuit: onQuit, livePreview: livePreview, spaceId: spaceId, environmentId: environmentId, cmaToken: cmaToken, host: host, tokensPath: tokensPath, initialFinalizeError: initialFinalizeError, ...(compositionMode !== 'atomic' ? { allowDeletions } : {}) }));
 }
 function FinalReviewAutoAccept({ generatedCount, onFinalize, }) {
     React.useEffect(() => {

package/dist/src/import/tui/runLivePreview.d.ts

@@ -26,6 +26,9 @@ export type RunLivePreviewOptions = {
      *  full delete. Lets the Finalize dialog show exactly what the accepted push
      *  would delete, independent of the session's on-disk generated rows. */
     acceptedKeys?: ReadonlySet<string>;
+    /** Forwarded verbatim to `previewImport`. Governs whether the response
+     *  includes removed entities or a suppressed-count summary instead. */
+    allowDeletions?: boolean;
 };
 /**
  * Pure async helper used by `useLivePreview` to re-fire `previewImport` after a

package/dist/src/import/tui/runLivePreview.js

@@ -60,7 +60,10 @@ export async function runLivePreview(opts) {
         timeoutHandle = setTimeout(() => reject(new TimeoutError()), timeoutMs);
     });
     try {
-        const response = (await Promise.race([client.previewImport(manifest), timeoutPromise]));
+        const response = (await Promise.race([
+            client.previewImport(manifest, opts.allowDeletions === true),
+            timeoutPromise,
+        ]));
         if (process.env['EDS_VERBOSE']) {
             const durationMs = Date.now() - startedAt;
             try {

package/dist/src/import/tui/steps/GenerateReviewStep.d.ts

@@ -11,6 +11,7 @@ type GenerateReviewStepProps = {
     host?: string;
     tokensPath?: string;
     initialFinalizeError?: string | null;
+    allowDeletions?: boolean;
 };
 export declare function sortComponentsForSidebar<T extends {
     key: string;
@@ -33,4 +34,4 @@ export interface BreakingRow {
 }
 export declare function buildBreakingRows(breakingChanges: BreakingComponent[]): BreakingRow[];
 export declare function deriveBreakingChanges(response: ServerPreviewResponse): BreakingComponent[];
-export declare function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: GenerateReviewStepProps): React.ReactElement;
+export declare function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: GenerateReviewStepProps): React.ReactElement;

package/dist/src/import/tui/steps/GenerateReviewStep.js

@@ -174,7 +174,7 @@ export function deriveBreakingChanges(response) {
     }
     return out;
 }
-export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview = true, spaceId = '', environmentId = '', cmaToken = '', host = '', tokensPath = '', initialFinalizeError = null, }) {
+export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, livePreview = true, spaceId = '', environmentId = '', cmaToken = '', host = '', tokensPath = '', initialFinalizeError = null, allowDeletions = false, }) {
     const { stdout } = useStdout();
     const terminalWidth = stdout?.columns ?? 80;
     const [components, setComponents] = useState([]);
@@ -271,9 +271,8 @@ export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, liveP
         cmaToken,
         host,
         onResult: handleLivePreviewResult,
-        // With nothing accepted, preview the delete-all diff so the review UI shows
-        // which existing components a push would remove (instead of an empty preview).
         deleteAllComponents: acceptedCountForPreview === 0,
+        allowDeletions,
     });
     const SPINNER_FRAMES = '⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏';
     const [spinnerTick, setSpinnerTick] = useState(0);
@@ -352,6 +351,7 @@ export function GenerateReviewStep({ extractSessionId, onFinalize, onQuit, liveP
         cmaToken,
         host,
         acceptedKeys: new Set(components.filter((c) => c.status === 'accepted').map((c) => c.key)),
+        allowDeletions,
     });
     const handleFinalizeConfirm = () => {
         const acceptedCount = components.filter((c) => c.status === 'accepted').length;

package/dist/src/import/tui/steps/WizardPreviewStep.d.ts

@@ -12,11 +12,14 @@ type WizardPreviewStepProps = {
     environmentId: string;
     stepNumber: number;
     totalSteps: number;
-    initialAllowDeletions?: boolean;
+    /** The value the preview was actually fetched with — not a hint. When
+     *  `false`, the server never returned removed entities, so there is
+     *  nothing to render item-by-item or toggle over. */
+    allowDeletions?: boolean;
     onConfirm: (acknowledge: boolean, allowDeletions: boolean) => void;
     onEdit?: () => void;
     onSaveFiles?: () => void;
     onQuit: () => void;
 };
-export declare function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, initialAllowDeletions, onConfirm, onEdit, onSaveFiles, onQuit, }: WizardPreviewStepProps): React.ReactElement;
+export declare function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, allowDeletions: fetchedAllowDeletions, onConfirm, onEdit, onSaveFiles, onQuit, }: WizardPreviewStepProps): React.ReactElement;
 export {};

package/dist/src/import/tui/steps/WizardPreviewStep.js

@@ -89,11 +89,14 @@ export function buildPreviewDiffLines(preview) {
     }
     return lines;
 }
-export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, initialAllowDeletions = false, onConfirm, onEdit, onSaveFiles, onQuit, }) {
+export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, allowDeletions: fetchedAllowDeletions = false, onConfirm, onEdit, onSaveFiles, onQuit, }) {
     const breakingWithImpact = hasBreakingChangesWithImpact(preview);
     const [diffExpanded, setDiffExpanded] = useState(false);
     const [scrollOffset, setScrollOffset] = useState(0);
-    const [allowDeletions, setAllowDeletions] = useState(initialAllowDeletions);
+    // Local state exists only to let the user opt OUT of a deletion the fetch
+    // already surfaced — it can never turn true when the fetch used false,
+    // because there's nothing in `preview` to reveal in that case.
+    const [allowDeletions, setAllowDeletions] = useState(fetchedAllowDeletions);
     const { stdout } = useStdout();
     const terminalRows = stdout?.rows ?? 40;
     const viewportHeight = Math.max(terminalRows - 14, 10);
@@ -107,12 +110,13 @@ export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber,
     }, [diffExpanded, preview]);
     const maxScroll = Math.max(0, allDiffLines.length - viewportHeight);
     const removedCount = preview.components.removed.length + preview.tokens.removed.length;
+    const suppressedCount = (preview.suppressedDeletions?.components ?? 0) + (preview.suppressedDeletions?.tokens ?? 0);
     useImmediateInput((input, key) => {
         if (key.return) {
             onConfirm(breakingWithImpact, allowDeletions);
             return;
         }
-        if ((input === 'x' || input === 'X') && removedCount > 0) {
+        if ((input === 'x' || input === 'X') && fetchedAllowDeletions && removedCount > 0) {
             setAllowDeletions((prev) => !prev);
             return;
         }
@@ -155,12 +159,12 @@ export function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber,
     const { components, tokens } = preview;
     const hasComponents = components.new.length + components.changed.length + components.removed.length > 0;
     const hasTokens = tokens.new.length + tokens.changed.length + tokens.removed.length > 0;
-    const hasAnything = hasComponents || hasTokens;
+    const hasAnything = hasComponents || hasTokens || suppressedCount > 0;
     return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(Text, { dimColor: true, children: '─'.repeat(40) }), _jsxs(Box, { gap: 1, children: [_jsxs(Text, { bold: true, children: ["Step ", stepNumber, " of ", totalSteps] }), _jsx(Text, { bold: true, children: "\u2014" }), _jsx(Text, { bold: true, children: "Push to Contentful" })] }), _jsx(Text, { dimColor: true, children: '─'.repeat(40) })] }), hasAnything ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: "Here's what will happen in your space:" }), hasComponents && (_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(Box, { gap: 1, marginTop: 1, children: _jsx(Text, { bold: true, dimColor: true, children: "ComponentTypes" }) }), components.new.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.success, children: " \uFF0B" }), _jsxs(Text, { children: [components.new.length, " will be created"] })] }), components.new.map((item, i) => {
                                         const name = item.key ?? item.$name ?? 'unknown';
                                         return (_jsxs(Text, { color: PALETTE.success, children: [' ', "+ ", name] }, `new-${i}`));
                                     })] })), components.changed.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \uFF5E" }), _jsxs(Text, { children: [components.changed.length, " will be updated"] })] }), components.changed.map((item, i) => {
                                         const isBreaking = item.changeClassification?.classification === 'breaking';
                                         return (_jsxs(Text, { color: isBreaking ? PALETTE.error : PALETTE.warning, children: [' ', isBreaking ? '⚠' : '~', " ", item.current.name] }, `chg-${i}`));
-                                    })] })), components.removed.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, children: allowDeletions ? ' ✗' : ' ⊘' }), _jsxs(Text, { children: [components.removed.length, " will be ", allowDeletions ? 'deleted' : 'skipped'] })] }), components.removed.map((item, i) => (_jsxs(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, dimColor: !allowDeletions, children: [' ', allowDeletions ? '✗' : '⊘', " ", item.name] }, `rm-${i}`)))] })), components.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [components.unchanged.length, " unchanged"] })] }))] })), hasTokens && (_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(Box, { gap: 1, marginTop: 1, children: _jsx(Text, { bold: true, dimColor: true, children: "Design Tokens" }) }), tokens.new.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.success, children: " \uFF0B" }), _jsxs(Text, { children: [tokens.new.length, " will be created"] })] })), tokens.changed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \uFF5E" }), _jsxs(Text, { children: [tokens.changed.length, " will be updated"] })] })), tokens.removed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, children: allowDeletions ? ' ✗' : ' ⊘' }), _jsxs(Text, { children: [tokens.removed.length, " will be ", allowDeletions ? 'deleted' : 'skipped'] })] })), tokens.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [tokens.unchanged.length, " unchanged"] })] }))] })), diffExpanded && allDiffLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: '─'.repeat(40) }), _jsxs(Text, { dimColor: true, children: [' ', "Diff (", allDiffLines.length, " lines) \u2014 line ", scrollOffset + 1, "\u2013", Math.min(scrollOffset + viewportHeight, allDiffLines.length), " of ", allDiffLines.length] }), _jsx(Box, { flexDirection: "column", children: allDiffLines.slice(scrollOffset, scrollOffset + viewportHeight).map((line) => (_jsx(Box, { children: line.element }, line.key))) }), maxScroll > 0 && _jsx(Text, { dimColor: true, children: " \u2195 j/k to scroll, f/b to page" })] }))] })) : (_jsx(Text, { dimColor: true, children: "Nothing to push \u2014 everything is already up to date." })), _jsxs(Box, { gap: 1, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Space:" }), _jsx(Text, { children: spaceId }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { dimColor: true, children: "Environment:" }), _jsx(Text, { children: environmentId })] }), breakingWithImpact && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: PALETTE.error, bold: true, children: "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply." }) })), allowDeletions && removedCount > 0 && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: PALETTE.error, bold: true, children: ["\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] }) })), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Push to Contentful" }), _jsxs(Text, { dimColor: true, children: ["[d] ", diffExpanded ? 'Hide' : 'Show', " diff"] }), diffExpanded && _jsx(Text, { dimColor: true, children: "[j/k] Scroll [f/b] Page" }), onEdit && _jsx(Text, { dimColor: true, children: "[e] Edit definitions" }), onSaveFiles && _jsx(Text, { dimColor: true, children: "[s] Save files instead" }), removedCount > 0 && (_jsxs(Text, { dimColor: true, children: ["[x] ", allowDeletions ? '[✓]' : '[ ]', " Also delete ", removedCount, " ", removedCount === 1 ? 'entity' : 'entities'] })), _jsx(Text, { dimColor: true, children: "[q] Cancel" })] })] }));
+                                    })] })), components.removed.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, children: allowDeletions ? ' ✗' : ' ⊘' }), _jsxs(Text, { children: [components.removed.length, " will be ", allowDeletions ? 'deleted' : 'skipped'] })] }), components.removed.map((item, i) => (_jsxs(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, dimColor: !allowDeletions, children: [' ', allowDeletions ? '✗' : '⊘', " ", item.name] }, `rm-${i}`)))] })), components.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [components.unchanged.length, " unchanged"] })] }))] })), hasTokens && (_jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(Box, { gap: 1, marginTop: 1, children: _jsx(Text, { bold: true, dimColor: true, children: "Design Tokens" }) }), tokens.new.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.success, children: " \uFF0B" }), _jsxs(Text, { children: [tokens.new.length, " will be created"] })] })), tokens.changed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \uFF5E" }), _jsxs(Text, { children: [tokens.changed.length, " will be updated"] })] })), tokens.removed.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: allowDeletions ? PALETTE.error : PALETTE.warning, children: allowDeletions ? ' ✗' : ' ⊘' }), _jsxs(Text, { children: [tokens.removed.length, " will be ", allowDeletions ? 'deleted' : 'skipped'] })] })), tokens.unchanged.length > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { dimColor: true, children: " \u00B7" }), _jsxs(Text, { dimColor: true, children: [tokens.unchanged.length, " unchanged"] })] }))] })), !fetchedAllowDeletions && suppressedCount > 0 && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: PALETTE.warning, children: " \u2298" }), _jsxs(Text, { children: [suppressedCount, " ", suppressedCount === 1 ? 'entity' : 'entities', " skipped (rerun with --allow-deletions to remove ", suppressedCount === 1 ? 'it' : 'them', ")"] })] })), diffExpanded && allDiffLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: '─'.repeat(40) }), _jsxs(Text, { dimColor: true, children: [' ', "Diff (", allDiffLines.length, " lines) \u2014 line ", scrollOffset + 1, "\u2013", Math.min(scrollOffset + viewportHeight, allDiffLines.length), " of ", allDiffLines.length] }), _jsx(Box, { flexDirection: "column", children: allDiffLines.slice(scrollOffset, scrollOffset + viewportHeight).map((line) => (_jsx(Box, { children: line.element }, line.key))) }), maxScroll > 0 && _jsx(Text, { dimColor: true, children: " \u2195 j/k to scroll, f/b to page" })] }))] })) : (_jsx(Text, { dimColor: true, children: "Nothing to push \u2014 everything is already up to date." })), _jsxs(Box, { gap: 1, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "Space:" }), _jsx(Text, { children: spaceId }), _jsx(Text, { dimColor: true, children: "/" }), _jsx(Text, { dimColor: true, children: "Environment:" }), _jsx(Text, { children: environmentId })] }), breakingWithImpact && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: PALETTE.error, bold: true, children: "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply." }) })), allowDeletions && removedCount > 0 && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: PALETTE.error, bold: true, children: ["\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] }) })), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[Enter] Push to Contentful" }), _jsxs(Text, { dimColor: true, children: ["[d] ", diffExpanded ? 'Hide' : 'Show', " diff"] }), diffExpanded && _jsx(Text, { dimColor: true, children: "[j/k] Scroll [f/b] Page" }), onEdit && _jsx(Text, { dimColor: true, children: "[e] Edit definitions" }), onSaveFiles && _jsx(Text, { dimColor: true, children: "[s] Save files instead" }), fetchedAllowDeletions && removedCount > 0 && (_jsxs(Text, { dimColor: true, children: ["[x] ", allowDeletions ? '[✓]' : '[ ]', " Also delete ", removedCount, " ", removedCount === 1 ? 'entity' : 'entities'] })), _jsx(Text, { dimColor: true, children: "[q] Cancel" })] })] }));
 }

package/dist/src/import/tui/useFinalizePreview.d.ts

@@ -11,6 +11,8 @@ export type UseFinalizePreviewOptions = {
     host: string;
     /** Component keys the operator has accepted; drives the scoped preview. */
     acceptedKeys: ReadonlySet<string>;
+    /** Forwarded verbatim to `runLivePreview`/`previewImport`. */
+    allowDeletions?: boolean;
 };
 export type UseFinalizePreviewReturn = {
     status: FinalizePreviewStatus;

package/dist/src/import/tui/useLivePreview.d.ts

@@ -12,6 +12,8 @@ export type UseLivePreviewOptions = {
     /** Preview an empty-but-present manifest (delete-all diff) when nothing is
      *  accepted, so the final-review UI can show what a push would delete. */
     deleteAllComponents?: boolean;
+    /** Forwarded verbatim to `runLivePreview`/`previewImport`. */
+    allowDeletions?: boolean;
 };
 export type LivePreviewStatus = 'idle' | 'running';
 export type UseLivePreviewReturn = {

package/dist/src/import/tui/useLivePreview.js

@@ -82,6 +82,7 @@ export function useLivePreview(opts) {
                 host: current.host,
                 generation,
                 deleteAllComponents: current.deleteAllComponents === true,
+                allowDeletions: current.allowDeletions === true,
             });
             // Discard stale responses (generation tag).
             if (result.generation !== latestRef.current)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.18.1-dev-build-2117d43.0",
+  "version": "2.18.1-dev-build-55a7404.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -34,9 +34,9 @@
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
     "react-dom": "^18.3.1",
-    "@contentful/experience-design-system-client": "2.18.1-dev-build-2117d43.0",
-    "@contentful/experience-design-system-types": "2.18.1-dev-build-2117d43.0",
-    "@contentful/experience-design-system-extraction": "2.18.1-dev-build-2117d43.0"
+    "@contentful/experience-design-system-types": "2.18.1-dev-build-55a7404.0",
+    "@contentful/experience-design-system-extraction": "2.18.1-dev-build-55a7404.0",
+    "@contentful/experience-design-system-client": "2.18.1-dev-build-55a7404.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.3",