@contentful/experience-design-system-cli 2.37.1-dev-build-0d4be259.0 → 2.37.1-dev-build-c3f4df22.0

package/dist/app.js

@@ -2018,7 +2018,7 @@ var init_cache_keys = __esm({
 
 // packages/experience-design-system-cli/app.tsx
 import { join as join25 } from "node:path";
-import { useEffect as useEffect27, useState as useState33 } from "react";
+import { useEffect as useEffect26, useState as useState33 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -20436,9 +20436,7 @@ async function runGeneration(input, onProgress, deps = realDeps3) {
     onProgress(progress);
   };
   const accepted = input.decisions.accepted;
-  update({ components: { done: 0, total: accepted.length, current: "Restoring cache..." } });
   const handedOverNames = await input.cachedNames.catch(() => []);
-  update({ components: { done: 0, total: accepted.length, current: "Starting generation..." } });
   try {
     await deps.saveDecisions({ sessionId: input.sessionId, decisions: input.decisions });
   } catch (error) {
@@ -20590,7 +20588,6 @@ function buildFlowStart(input) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/screen.tsx
-import { useEffect as useEffect20, useRef as useRef12 } from "react";
 import { Box as Box41 } from "ink";
 
 // packages/experience-design-system-types/dist/src/cdf/validate.js
@@ -26991,18 +26988,10 @@ function FlowScreen({
   controller,
   livePreview = true,
   generatePromptPath,
-  onExit,
-  onStepChange
+  onExit
 }) {
   const totalSteps = totalStepsFor(state);
   const quit = () => onExit(0);
-  const previousStep = useRef12(state.step);
-  useEffect20(() => {
-    if (previousStep.current !== state.step) {
-      onStepChange?.();
-      previousStep.current = state.step;
-    }
-  }, [state.step, onStepChange]);
   const content = (() => {
     switch (state.step) {
       case "final-review":
@@ -27128,7 +27117,7 @@ function FlowScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect21, useRef as useRef13, useSyncExternalStore } from "react";
+import { useEffect as useEffect20, useRef as useRef12, useSyncExternalStore } from "react";
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/controller.ts
 import { appendFileSync, writeFileSync } from "node:fs";
@@ -27718,6 +27707,12 @@ function createFlowController(start, deps) {
       deps.log({ update: sanitizeForLog(patch) });
     } catch {
     }
+    if (patch.step !== void 0 && patch.step !== state.step) {
+      try {
+        deps.beforeStepChange?.();
+      } catch {
+      }
+    }
     state = { ...state, ...patch };
     for (const listener of listeners) listener();
   };
@@ -27855,28 +27850,32 @@ function createFlowController(start, deps) {
 }
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-function useFlow(start, deps = realFlowDeps) {
-  const controller = useRef13();
+function useFlow(start, options = {}) {
+  const controller = useRef12();
   if (start && !controller.current) {
     try {
       startWizardLog();
     } catch {
     }
-    controller.current = createFlowController(start, deps());
+    const flowDeps = (options.deps ?? realFlowDeps)();
+    controller.current = createFlowController(start, {
+      ...flowDeps,
+      ...options.beforeStepChange ? { beforeStepChange: options.beforeStepChange } : {}
+    });
   }
   const current = controller.current;
   const state = useSyncExternalStore(
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect21(() => {
+  useEffect20(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state ? { controller: current, state } : void 0;
 }
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect22, useState as useState27 } from "react";
+import { useEffect as useEffect21, useState as useState27 } from "react";
 import { Box as Box42, Text as Text44, useInput as useInput9 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/debug-store.ts
@@ -28070,7 +28069,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState27();
-  useEffect22(() => {
+  useEffect21(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -28163,7 +28162,7 @@ function SettingsScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect23, useState as useState29 } from "react";
+import { useEffect as useEffect22, useState as useState29 } from "react";
 import { Box as Box44, Text as Text46, useInput as useInput11 } from "ink";
 import TextInput4 from "ink-text-input";
 
@@ -28231,7 +28230,7 @@ function ConfigurationScreen({ onDone }) {
   const [lastSaved, setLastSaved] = useState29(null);
   const [editing, setEditing] = useState29(false);
   const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
-  useEffect23(() => {
+  useEffect22(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       setStage("form");
@@ -28368,7 +28367,7 @@ function ConfigurationScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect24, useState as useState30 } from "react";
+import { useEffect as useEffect23, useState as useState30 } from "react";
 import { Box as Box45, Text as Text47, useInput as useInput12 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
@@ -28391,7 +28390,7 @@ import { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState30(true);
   const [enabled, setEnabled] = useState30(true);
-  useEffect24(() => {
+  useEffect23(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28445,13 +28444,13 @@ function OptInAnalyticsScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect25, useState as useState31 } from "react";
+import { useEffect as useEffect24, useState as useState31 } from "react";
 import { Box as Box46, Text as Text48, useInput as useInput13 } from "ink";
 import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
 var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
 function UpgradeScreen({ onDone }) {
   const [upgradeCheck, setUpgradeCheck] = useState31();
-  useEffect25(() => {
+  useEffect24(() => {
     startDebugRun({
       flow: "upgrade",
       step: "01-upgrade",
@@ -28516,13 +28515,13 @@ function renderBody(upgradeCheck) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect26, useState as useState32 } from "react";
+import { useEffect as useEffect25, useState as useState32 } from "react";
 import { Box as Box47, Text as Text49, useInput as useInput14 } from "ink";
 import { jsx as jsx58, jsxs as jsxs48 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
   const [loading, setLoading] = useState32(true);
   const [enabled, setEnabled] = useState32(true);
-  useEffect26(() => {
+  useEffect25(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28600,9 +28599,9 @@ function App({ importOptions, inkClear }) {
   const [generationInput, setGenerationInput] = useState33();
   const generation = useGeneration(generationInput);
   const [flowStart, setFlowStart] = useState33();
-  const flow = useFlow(flowStart);
+  const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState33();
-  useEffect27(() => {
+  useEffect26(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -28660,12 +28659,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect27(() => {
+  useEffect26(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect27(() => {
+  useEffect26(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -28683,7 +28682,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect27(() => {
+  useEffect26(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -28734,8 +28733,7 @@ function App({ importOptions, inkClear }) {
             state: flow.state,
             controller: flow.controller,
             generatePromptPath: flowStart.generatePromptPath,
-            onExit: setImportExitCode,
-            onStepChange: inkClear
+            onExit: setImportExitCode
           }
         );
       }

package/dist/index.js

@@ -24053,9 +24053,7 @@ async function runGeneration(input, onProgress, deps = realDeps3) {
     onProgress(progress);
   };
   const accepted = input.decisions.accepted;
-  update({ components: { done: 0, total: accepted.length, current: "Restoring cache..." } });
   const handedOverNames = await input.cachedNames.catch(() => []);
-  update({ components: { done: 0, total: accepted.length, current: "Starting generation..." } });
   try {
     await deps.saveDecisions({ sessionId: input.sessionId, decisions: input.decisions });
   } catch (error) {
@@ -30172,7 +30170,6 @@ var init_generate_review_step = __esm({
     init_review_input();
     init_use_review_preview();
     init_LivePreviewSummary();
-    init_cycle_auto_reject();
     HELP_SECTIONS2 = [
       {
         title: "Navigation",
@@ -31140,7 +31137,6 @@ var init_run_teaser = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/screen.tsx
-import { useEffect as useEffect20, useRef as useRef12 } from "react";
 import { Box as Box41 } from "ink";
 import { jsx as jsx52, jsxs as jsxs42 } from "react/jsx-runtime";
 function totalStepsFor(state) {
@@ -31156,18 +31152,10 @@ function FlowScreen({
   controller,
   livePreview = true,
   generatePromptPath,
-  onExit,
-  onStepChange
+  onExit
 }) {
   const totalSteps = totalStepsFor(state);
   const quit = () => onExit(0);
-  const previousStep = useRef12(state.step);
-  useEffect20(() => {
-    if (previousStep.current !== state.step) {
-      onStepChange?.();
-      previousStep.current = state.step;
-    }
-  }, [state.step, onStepChange]);
   const content = (() => {
     switch (state.step) {
       case "final-review":
@@ -31935,6 +31923,12 @@ function createFlowController(start, deps) {
       deps.log({ update: sanitizeForLog(patch) });
     } catch {
     }
+    if (patch.step !== void 0 && patch.step !== state.step) {
+      try {
+        deps.beforeStepChange?.();
+      } catch {
+      }
+    }
     state = { ...state, ...patch };
     for (const listener of listeners) listener();
   };
@@ -32087,22 +32081,26 @@ var init_controller = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/10-flow/flow/use-flow.ts
-import { useEffect as useEffect21, useRef as useRef13, useSyncExternalStore } from "react";
-function useFlow(start, deps = realFlowDeps) {
-  const controller = useRef13();
+import { useEffect as useEffect20, useRef as useRef12, useSyncExternalStore } from "react";
+function useFlow(start, options = {}) {
+  const controller = useRef12();
   if (start && !controller.current) {
     try {
       startWizardLog();
     } catch {
     }
-    controller.current = createFlowController(start, deps());
+    const flowDeps = (options.deps ?? realFlowDeps)();
+    controller.current = createFlowController(start, {
+      ...flowDeps,
+      ...options.beforeStepChange ? { beforeStepChange: options.beforeStepChange } : {}
+    });
   }
   const current = controller.current;
   const state = useSyncExternalStore(
     (listener) => current?.subscribe(listener) ?? (() => void 0),
     () => current?.getState()
   );
-  useEffect21(() => {
+  useEffect20(() => {
     if (!start) controller.current = void 0;
   }, [start]);
   return current && state ? { controller: current, state } : void 0;
@@ -32315,7 +32313,7 @@ var init_help_info = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
-import { useEffect as useEffect22, useState as useState27 } from "react";
+import { useEffect as useEffect21, useState as useState27 } from "react";
 import { Box as Box42, Text as Text44, useInput as useInput9 } from "ink";
 import { Fragment as Fragment16, jsx as jsx53, jsxs as jsxs43 } from "react/jsx-runtime";
 function Section({ title, rows }) {
@@ -32329,7 +32327,7 @@ function Section({ title, rows }) {
 }
 function HelpScreen({ onDone }) {
   const [info, setInfo] = useState27();
-  useEffect22(() => {
+  useEffect21(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
     void readHelpInfo().then(setInfo);
   }, []);
@@ -32478,7 +32476,7 @@ var init_config_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect23, useState as useState29 } from "react";
+import { useEffect as useEffect22, useState as useState29 } from "react";
 import { Box as Box44, Text as Text46, useInput as useInput11 } from "ink";
 import TextInput4 from "ink-text-input";
 import { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
@@ -32500,7 +32498,7 @@ function ConfigurationScreen({ onDone }) {
   const [lastSaved, setLastSaved] = useState29(null);
   const [editing, setEditing] = useState29(false);
   const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
-  useEffect23(() => {
+  useEffect22(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
       setStage("form");
@@ -32684,13 +32682,13 @@ var init_analytics_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect24, useState as useState30 } from "react";
+import { useEffect as useEffect23, useState as useState30 } from "react";
 import { Box as Box45, Text as Text47, useInput as useInput12 } from "ink";
 import { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
   const [loading, setLoading] = useState30(true);
   const [enabled, setEnabled] = useState30(true);
-  useEffect24(() => {
+  useEffect23(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -32753,12 +32751,12 @@ var init_screen11 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect25, useState as useState31 } from "react";
+import { useEffect as useEffect24, useState as useState31 } from "react";
 import { Box as Box46, Text as Text48, useInput as useInput13 } from "ink";
 import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
 function UpgradeScreen({ onDone }) {
   const [upgradeCheck, setUpgradeCheck] = useState31();
-  useEffect25(() => {
+  useEffect24(() => {
     startDebugRun({
       flow: "upgrade",
       step: "01-upgrade",
@@ -32833,13 +32831,13 @@ var init_PageContainer4 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect26, useState as useState32 } from "react";
+import { useEffect as useEffect25, useState as useState32 } from "react";
 import { Box as Box47, Text as Text49, useInput as useInput14 } from "ink";
 import { jsx as jsx58, jsxs as jsxs48 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
   const [loading, setLoading] = useState32(true);
   const [enabled, setEnabled] = useState32(true);
-  useEffect26(() => {
+  useEffect25(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -32902,7 +32900,7 @@ __export(app_exports, {
   runApp: () => runApp
 });
 import { join as join27 } from "node:path";
-import { useEffect as useEffect27, useState as useState33 } from "react";
+import { useEffect as useEffect26, useState as useState33 } from "react";
 import { Fragment as Fragment19, jsx as jsx59 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState33("start");
@@ -32932,9 +32930,9 @@ function App({ importOptions, inkClear }) {
   const [generationInput, setGenerationInput] = useState33();
   const generation = useGeneration(generationInput);
   const [flowStart, setFlowStart] = useState33();
-  const flow = useFlow(flowStart);
+  const flow = useFlow(flowStart, { beforeStepChange: inkClear });
   const [importDefaults, setImportDefaults] = useState33();
-  useEffect27(() => {
+  useEffect26(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -32992,12 +32990,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect27(() => {
+  useEffect26(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect27(() => {
+  useEffect26(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -33015,7 +33013,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect27(() => {
+  useEffect26(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -33066,8 +33064,7 @@ function App({ importOptions, inkClear }) {
             state: flow.state,
             controller: flow.controller,
             generatePromptPath: flowStart.generatePromptPath,
-            onExit: setImportExitCode,
-            onStepChange: inkClear
+            onExit: setImportExitCode
           }
         );
       }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-0d4be259.0",
+  "version": "2.37.1-dev-build-c3f4df22.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/import/steps/03-path-validation/helpers/scan-files.d.ts

@@ -1,10 +1,2 @@
-import { collectFiles } from '@contentful/experience-design-system-backend-pipeline';
-import type { FileCounts as LocalFileCounts, ScanResult } from '../logic.js';
-type CollectedFilesOutcome = ReturnType<typeof collectFiles>;
-type PipelineFileCounts = Extract<CollectedFilesOutcome, {
-    ok: true;
-}>['result']['counts'];
+import type { ScanResult } from '../logic.js';
 export declare function scanFiles(directory: string): ScanResult;
-export declare function toScanResult(outcome: CollectedFilesOutcome): ScanResult;
-export declare function foldSvelteAndMdIntoOther(counts: PipelineFileCounts): LocalFileCounts;
-export {};

package/dist/src/tui/import/steps/03-path-validation/logic.d.ts

@@ -32,10 +32,6 @@ interface Key {
     escape: boolean;
     return: boolean;
 }
-export declare function emptyCounts(): FileCounts;
-export declare function addFile(counts: FileCounts, fileName: string): FileCounts;
-export declare function mergeCounts(a: FileCounts, b: FileCounts): FileCounts;
-export declare function failureFromErrorCode(code: string | undefined): ScanFailureCode;
 export declare function describeFailure(failure: ScanFailureCode, path: string): FailureMessage;
 export declare function summarize(counts: FileCounts): Summary;
 export declare function phaseOf(scan: ScanResult | undefined): PathPhase;

package/dist/src/tui/import/steps/07-scope-gate/columns.d.ts

@@ -4,8 +4,6 @@ export interface ScopeComponentLike {
     name: string;
 }
 import type { Decision } from './types.js';
-export declare const SCOPE_GATE_MAIN_COLUMN_WIDTH = 54;
-export declare const ACCEPTED_COMPONENTS_COLUMN_WIDTH = 36;
 export interface ScopeGatePanelLayout {
     height: number;
     mainVisibleCount: number;

package/dist/src/tui/import/steps/07-scope-gate/graph/fuzzy-search.d.ts

@@ -1,3 +1 @@
 export declare function fuzzyMatches(query: string, text: string): boolean;
-export declare function fuzzyScore(query: string, text: string): number | null;
-export declare function fuzzyFilter(query: string, candidates: string[]): string[];

package/dist/src/tui/import/steps/07-scope-gate/graph/lineage.d.ts

@@ -3,27 +3,5 @@ export interface LineageParentEdge {
     parent: string;
     slotName: string;
 }
-export interface LineageEdge {
-    from: string;
-    slotName: string;
-    to: string;
-}
-export type LineageChain = LineageEdge[];
 export declare function findDirectParents(target: string, components: ComponentGraphNode[]): LineageParentEdge[];
 export declare function findAllAncestors(target: string, components: ComponentGraphNode[]): Set<string>;
-export declare function findAllAncestorChains(target: string, components: ComponentGraphNode[]): LineageChain[];
-export interface AncestorTreeNode {
-    name: string;
-    incomingSlotName?: string;
-    depth: number;
-    shared: boolean;
-    cycle: boolean;
-    parents: AncestorTreeNode[];
-}
-export declare function buildAncestorTree(target: string, components: ComponentGraphNode[]): AncestorTreeNode;
-export interface AncestorTreeLine {
-    text: string;
-    jumpTarget?: string;
-    depth: number;
-}
-export declare function renderAncestorTree(node: AncestorTreeNode): AncestorTreeLine[];

package/dist/src/tui/import/steps/07-scope-gate/sidebar/ai-flag.d.ts

@@ -3,4 +3,3 @@ export type AiFlaggable = {
     needsReview?: boolean;
 };
 export declare function isAiFlagged(row: AiFlaggable): boolean;
-export declare function isDefaultIncluded(row: AiFlaggable): boolean;

package/dist/src/tui/import/steps/07-scope-gate/sidebar/components/GroupedSidebar.d.ts

@@ -56,38 +56,5 @@ export declare function buildVisibleRows(props: {
     graph: ComponentGraphNode[];
     filterVisibleKeys?: Set<string>;
 }): VisibleRow[];
-export declare function visibleItemOrder(props: {
-    items: GroupedSidebarItem[];
-    cycleParticipants: Set<string>;
-    expandedGroups: Set<string>;
-    alwaysExpanded?: boolean;
-    showFlatTier?: boolean;
-    graph: ComponentGraphNode[];
-}): number[];
-export declare function labelStyleFor(input: {
-    row: VisibleRow;
-    isCursor: boolean;
-    wouldDim: boolean;
-}): {
-    color: string | undefined;
-    bold: boolean;
-    dim: boolean;
-};
-export declare function selectionGlyphStyleFor(selState: 'accepted' | 'rejected' | 'undecided' | undefined, isCycleRow: boolean): {
-    glyph: string | null;
-    color: string | undefined;
-    dim: boolean;
-    bold: boolean;
-};
-export declare function inheritanceGlyphStyleFor(input: {
-    status: RenderStatus['status'] | undefined;
-    isOwn: boolean;
-    isCursor: boolean;
-}): {
-    glyph: string | null;
-    color: string | undefined;
-    dim: boolean;
-    bold: boolean;
-};
 export declare function GroupedSidebar(props: GroupedSidebarProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/07-scope-gate/sidebar/lineage-layout.d.ts

@@ -1,10 +1,3 @@
-/** Maximum layout rows; the active terminal height determines the actual budget. */
-export declare const VISIBLE_COUNT = 200;
-/** Maximum supported panel window; normal terminals remain terminal-sized. */
-export declare const MAX_PANEL_ROWS = 200;
-/** Floors — both surfaces stay usable even on a small terminal. */
-export declare const SIDEBAR_MIN = 4;
-export declare const MIN_PANEL_ROWS = 4;
 /**
  * Fallback when `stdout.rows` is unavailable (piped output, tests). No TTY
  * means Ink is not interactively repainting, so there is no flicker risk — we
@@ -12,23 +5,6 @@ export declare const MIN_PANEL_ROWS = 4;
  * render is complete and unclipped.
  */
 export declare const FALLBACK_ROWS = 40;
-/**
- * Vertical space consumed by everything ABOVE/BELOW the columns row. The panel
- * shares the columns row, so the fit constraint while open is simply
- * `FIXED_OVERHEAD + panelBoxHeight <= rows`.
- */
-export declare const FIXED_OVERHEAD: number;
-export declare const PANEL_BOX_CHROME = 6;
-/**
- * L2e — fixed vertical chrome around the sidebar in the BASE (no-panel) case,
- * counting EVERYTHING that is not a variable sidebar entry row: the wizard
- * header bar, the counter strip (with its blank separator), the cycle banner,
- * the nothing-selected /
- * AI-exclusion hint, the GroupedSidebar box borders + scroll indicator, the
- * focused-detail block, and the wrapping legend region. The value intentionally
- * leaves a small safety margin so resize-induced wrapping does not overflow.
- */
-export declare const BASE_CHROME_OVERHEAD = 18;
 export interface LineageLayoutInput {
     /** Terminal height in rows (`stdout.rows`, or the fallback). */
     rows: number;
@@ -37,18 +13,6 @@ export interface LineageLayoutInput {
     /** Number of lineage entries — caps the panel window so it never over-allocates. */
     entryCount?: number;
 }
-export interface LineageLayout {
-    /** Rows the sidebar should render (`visibleCount`). Constant across open/closed. */
-    sidebarVisible: number;
-    /** Rows a sidebar replacement panel should window to (`maxRows`). */
-    panelMaxRows: number;
-}
-/**
- * The sidebar height is constant (the panel replaces it in the same slot, so
- * there is nothing to shrink). Both values are derived from the terminal so
- * resizing grows or shrinks the viewport without content-driven layout changes.
- */
-export declare function computeLineageLayout({ rows, panelOpen, entryCount }: LineageLayoutInput): LineageLayout;
 export interface SidebarBudget {
     /** Rows the GroupedSidebar should render (`visibleCount`). */
     sidebarVisibleCount: number;

package/dist/src/tui/import/steps/09-review/components/FieldEditor.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { findSlotCycles, type ComponentSlotInfo } from '../../07-scope-gate/graph/cycle-detection.js';
+import { type ComponentSlotInfo } from '../../07-scope-gate/graph/cycle-detection.js';
 type PropMetadata = {
     rationale?: string | null;
     sourceStartLine?: number | null;
@@ -46,22 +46,5 @@ export type FieldEditorProps = {
     header?: React.ReactNode;
     headerHeight?: number;
 };
-export declare function simulateGraphWithCandidate(projectSlotGraph: ComponentSlotInfo[], selfName: string, currentSlots: {
-    name: string;
-    allowedComponents: string[];
-}[], targetSlotName: string, candidate: string): ComponentSlotInfo[];
-export declare function introducesNewCycle(before: ReturnType<typeof findSlotCycles>, next: ReturnType<typeof findSlotCycles>): boolean;
-export declare function computeAllowedComponentCandidates(projectSlotGraph: ComponentSlotInfo[], selfName: string, currentSlots: {
-    name: string;
-    allowedComponents: string[];
-}[], targetSlotName: string): string[];
-export declare function simulateGraphWithReplacement(projectSlotGraph: ComponentSlotInfo[], selfName: string, currentSlots: {
-    name: string;
-    allowedComponents: string[];
-}[], targetSlotName: string, replaceIndex: number, candidate: string): ComponentSlotInfo[];
-export declare function computeAllowedComponentReplacementCandidates(projectSlotGraph: ComponentSlotInfo[], selfName: string, currentSlots: {
-    name: string;
-    allowedComponents: string[];
-}[], targetSlotName: string, replaceIndex: number): string[];
 export declare function FieldEditor({ value, width, height, fixedHeight, active, onChange, onSave, onDiscard, onExit, metadata, onTogglePropRationale, propRationaleKey, onToggleComponentRationale, componentRationaleKey, onToggleSourceExternal, onTextEntryActiveChange, projectSlotGraph, currentComponentName, onDirtyChange, discardTrigger, initialFocusTarget, showHiddenProps, showInlineRationales, header, headerHeight, }: FieldEditorProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/09-review/components/ReviewDialogs.d.ts

@@ -1,21 +1,7 @@
 import React from 'react';
-import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
 import type { UseFinalizePreviewReturn } from '../use-finalize-preview.js';
 import type { UseReviewSurfaceStateResult } from '../use-review-surface-state.js';
 import { type ReviewStatusEntry } from './ReviewStatus.js';
-export type ReviewFinalizeDialogsProps = {
-    showFinalize: boolean;
-    showQuit: boolean;
-    components: ReadonlyArray<ReviewStatusEntry>;
-    removed?: ComponentTypeSummary[];
-    previewStatus?: 'idle' | 'running' | 'done' | 'error';
-    removedScrollOffset?: number;
-    onFinalizeConfirm: () => void;
-    onFinalizeCancel: () => void;
-    onQuitConfirm: () => void;
-    onQuitCancel: () => void;
-};
-export declare function ReviewFinalizeDialogs({ showFinalize, showQuit, components, removed, previewStatus, removedScrollOffset, onFinalizeConfirm, onFinalizeCancel, onQuitConfirm, onQuitCancel, }: ReviewFinalizeDialogsProps): React.ReactElement;
 export declare function ReviewStepDialogs({ surfaceState, components, finalizePreview, onFinalize, onQuit, }: {
     surfaceState: UseReviewSurfaceStateResult;
     components: ReadonlyArray<ReviewStatusEntry>;

package/dist/src/tui/import/steps/09-review/components/TokenReviewPanel.d.ts

@@ -1,21 +1,15 @@
 import React from 'react';
-import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
 export type TokenPropSuggestion = {
     propName: string;
     paths: string[];
     suggested: string[];
     allowed: string[];
 };
-export type TokenReviewToken = {
-    path: string;
-    kind: string;
-};
 /**
  * Design-token props on `entry` with a declared token kind. `paths` is the
  * full compatible token universe when a token catalog is available; `allowed`
  * remains the current subset.
  */
-export declare function collectTokenSuggestions(entry: CDFComponentEntry, availableTokens?: TokenReviewToken[]): TokenPropSuggestion[];
 export type TokenReviewPanelProps = {
     componentName: string;
     suggestions: TokenPropSuggestion[];

package/dist/src/tui/import/steps/09-review/generate-review-step.d.ts

@@ -1,5 +1,4 @@
 import React from 'react';
-import type { BreakingChange, CDFComponentEntry, ComponentTypeSummary, DownstreamImpact, ServerPreviewResponse } from '@contentful/experience-design-system-types';
 type GenerateReviewStepProps = {
     extractSessionId: string | null;
     tokenSessionId?: string | null;
@@ -13,25 +12,5 @@ type GenerateReviewStepProps = {
     tokensPath?: string;
     initialFinalizeError?: string | null;
 };
-export declare function sortComponentsForSidebar<T extends {
-    key: string;
-    entry: CDFComponentEntry;
-}>(components: T[], cycleParticipants?: Set<string>): T[];
-export { computeCycleAutoRejectTargets } from './graph/cycle-auto-reject.js';
-export interface BreakingComponent {
-    componentName: string;
-    changes: BreakingChange[];
-    impact?: DownstreamImpact;
-    current?: ComponentTypeSummary;
-}
-export interface BreakingRow {
-    label: string;
-    componentName: string;
-    focusTarget?: {
-        kind: 'prop' | 'slot';
-        name: string;
-    };
-}
-export declare function buildBreakingRows(breakingChanges: BreakingComponent[]): BreakingRow[];
-export declare function deriveBreakingChanges(response: ServerPreviewResponse): BreakingComponent[];
 export declare function GenerateReviewStep(props: GenerateReviewStepProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/09-review/helpers/cycle-panel-scroll.d.ts

@@ -1,8 +1,4 @@
-export declare const CYCLE_PANEL_PREAMBLE_LINES = 4;
 export interface CyclePanelLineCountable {
     suggestedBreak?: unknown;
 }
-export declare function cycleLineCount(cycle: CyclePanelLineCountable): number;
-export declare function cycleLineOffsets(cycles: readonly CyclePanelLineCountable[], preamble?: number): number[];
-export declare function totalCyclePanelLines(cycles: readonly CyclePanelLineCountable[], preamble?: number): number;
 export declare function followCycleScroll(currentScroll: number, cursorIdx: number, cycles: readonly CyclePanelLineCountable[], panelHeight: number, preamble?: number): number;

package/dist/src/tui/import/steps/09-review/run-live-preview.d.ts

@@ -1,7 +1,4 @@
 import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
-export declare class TimeoutError extends Error {
-    constructor(message?: string);
-}
 export type LivePreviewResult = {
     generation: number;
     response: ServerPreviewResponse | null;

package/dist/src/tui/import/steps/09-review/use-finalize-preview.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
 type FinalizePreviewStatus = 'idle' | 'running' | 'done' | 'error';
-export type UseFinalizePreviewOptions = {
+type UseFinalizePreviewOptions = {
     /** True while the Finalize dialog is open. Toggling true (re)fires the preview. */
     open: boolean;
     extractSessionId: string | null;
@@ -26,14 +26,4 @@ export type UseReviewFinalizePreviewOptions = Omit<UseFinalizePreviewOptions, 'a
     }>;
 };
 export declare function useReviewFinalizePreview({ components, ...options }: UseReviewFinalizePreviewOptions): UseFinalizePreviewReturn;
-/**
- * Shared Finalize-dialog preview, used by both the composite and atomic
- * generate-review steps.
- *
- * When the dialog opens it fires a preview scoped to the ACCEPTED set (so the
- * result reflects exactly what the push does, independent of the session's
- * not-yet-reclassified generated rows), tracks loading/error, and owns the
- * scroll offset for the preview list.
- */
-export declare function useFinalizePreview(opts: UseFinalizePreviewOptions): UseFinalizePreviewReturn;
 export {};

package/dist/src/tui/import/steps/10-flow/flow/controller.d.ts

@@ -1,9 +1,8 @@
-import { type PreviewValidationError } from '@contentful/experience-design-system-backend-pipeline';
 import type { ImportHandoff } from '@contentful/experience-design-system-types/handoff';
 import { type PreviewDeps } from './preview.js';
 import { type PushDeps } from './push.js';
 import { type SaveDeps } from './save.js';
-import { type FlowPatch, type FlowState } from './types.js';
+import { type FlowState } from './types.js';
 /** What the flow starts from: what the earlier stages produced, and the user's saved settings. */
 export interface FlowStart {
     handoff: ImportHandoff;
@@ -38,15 +37,15 @@ export interface FlowDeps {
     /** Writes one line of the wizard's step log. */
     log: (entry: Record<string, unknown>) => void;
     stderr: (text: string) => void;
+    /**
+     * Called when the step is about to change, before anything is told about the new one. The host clears the terminal
+     * here so the next screen is drawn on a clean one. It has to be before: Ink paints as soon as it is told, and a clear
+     * after the paint wipes a static screen like the done step, which nothing draws again.
+     */
+    beforeStepChange?: () => void;
 }
 export declare function startWizardLog(): void;
 export declare function realFlowDeps(): FlowDeps;
-/** The state the flow begins in, from what the earlier stages handed over. */
-export declare function initialFlowState(start: FlowStart): FlowState;
-/** What the log gets: the state change without the token, the document, or the whole of a large server response. */
-export declare function sanitizeForLog(partial: FlowPatch): Record<string, unknown>;
-/** The names of the components the errors are about, once each. */
-export declare function namesToSkip(errors: readonly PreviewValidationError[]): string[];
 export interface FlowController {
     getState(): FlowState;
     subscribe(listener: () => void): () => void;

package/dist/src/tui/import/steps/10-flow/flow/preview.d.ts

@@ -1,5 +1,5 @@
 import type { DatabaseSync } from 'node:sqlite';
-import { ApiError, patchReviewStateWithValidationErrors, type PreviewValidationError } from '@contentful/experience-design-system-backend-pipeline';
+import { patchReviewStateWithValidationErrors } from '@contentful/experience-design-system-backend-pipeline';
 import { type CDFDocument, type DTCGTokenEntry, type ServerPreviewResponse } from '@contentful/experience-design-system-types';
 import type { FlowPatch, FlowState } from './types.js';
 type PreviewClient = {
@@ -30,20 +30,6 @@ export interface RunPreviewInput {
     /** Set when nothing was accepted, so the document is present but empty and the server shows what would be deleted. */
     deleteAll: boolean;
 }
-/** What to do with a 422 from the preview: show the components that failed, or fall through to the generic error. */
-type Preview422Outcome = {
-    kind: 'validation-error';
-    errors: PreviewValidationError[];
-    missingNames: string[];
-} | {
-    kind: 'unparseable';
-    message: string;
-} | {
-    kind: 'not-422';
-};
-export declare function handlePreview422(err: ApiError, extractSessionId: string | null, patchFn: PreviewDeps['patchReviewState']): Promise<Preview422Outcome>;
-/** The patch to spread into any update that leaves the validation error step, so stale errors do not linger. */
-export declare function clearedValidationErrorState(): Pick<FlowState, 'previewValidationErrors' | 'previewValidationMissingNames'>;
 /**
  * Loads what would be pushed and asks the server what that would change. Returns the patch the wizard applied: the
  * preview gate, a terminal "done" when nothing would change, the validation error step for a 422, or an error.

package/dist/src/tui/import/steps/10-flow/flow/save.d.ts

@@ -1,16 +1,7 @@
 import type { DatabaseSync } from 'node:sqlite';
 import { appendRun, buildSourceFingerprint } from '@contentful/experience-design-system-backend-pipeline';
-import { type CDFComponentEntry, type CDFDocument, type DTCGTokenEntry } from '@contentful/experience-design-system-types';
+import { type DTCGTokenEntry } from '@contentful/experience-design-system-types';
 import type { FlowPatch, FlowState } from './types.js';
-/** How long the confirmation of a written file stays up before the flow moves on to the preview. */
-export declare const SAVE_CONFIRMATION_DELAY_MS = 1000;
-/** The document written to `components.json`: the components and tokens as one schema-valid CDF. */
-export declare function buildSavedCDF(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>, tokens: DTCGTokenEntry[], opts?: {
-    deleteAll?: boolean;
-}): CDFDocument;
 /** The outside world saving talks to, so each branch can be tested without a disk, a database or a clock. */
 export interface SaveDeps {
     openDb: () => DatabaseSync;

package/dist/src/tui/import/steps/10-flow/flow/screen.d.ts

@@ -8,12 +8,6 @@ interface FlowScreenProps {
     generatePromptPath?: string;
     /** Leaves the import with the exit code the wizard would have exited with. */
     onExit: (exitCode: number) => void;
-    /** Called when the step changes so the host can clear Ink's render buffer without scrollback pollution. */
-    onStepChange?: () => void;
 }
-/** How many steps the import has, as the wizard counted them. */
-export declare function totalStepsFor(state: Pick<FlowState, 'tokensPath' | 'rawTokensPath' | 'mapTokensEligible'>): number;
-/** Whether the preview gate offers "[e] Edit definitions": only when the document has components to edit. */
-export declare function canEditFromPreview(cdf: FlowState['cdf']): boolean;
-export declare function FlowScreen({ state, controller, livePreview, generatePromptPath, onExit, onStepChange, }: FlowScreenProps): React.ReactElement;
+export declare function FlowScreen({ state, controller, livePreview, generatePromptPath, onExit, }: FlowScreenProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/10-flow/flow/use-flow.d.ts

@@ -3,7 +3,10 @@ import { type FlowController, type FlowDeps, type FlowStart } from './controller
  * The flow for a start, once. `start` is undefined until the generation stage has finished, so the hook can be called
  * unconditionally; the step log is started with the controller, as the wizard started it with its first render.
  */
-export declare function useFlow(start: FlowStart | undefined, deps?: () => FlowDeps): {
+export declare function useFlow(start: FlowStart | undefined, options?: {
+    beforeStepChange?: () => void;
+    deps?: () => FlowDeps;
+}): {
     controller: FlowController;
     state: ReturnType<FlowController['getState']>;
 } | undefined;

package/dist/src/tui/import/steps/10-flow/screens/WizardPreviewStep.d.ts

@@ -1,11 +1,5 @@
 import React from 'react';
 import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
-export interface PreviewDiffLine {
-    key: string;
-    color: string;
-    text: string;
-}
-export declare function buildPreviewSummaryLines(preview: ServerPreviewResponse): PreviewDiffLine[];
 type WizardPreviewStepProps = {
     preview: ServerPreviewResponse;
     spaceId: string;

package/dist/src/tui/import/steps/10-flow/support/path-utils.d.ts

@@ -1,8 +1,3 @@
-/**
- * Expands a leading `~` to the user's home directory.
- * Exported separately so it can be unit-tested and reused.
- */
-export declare function expandTilde(input: string): string;
 /**
  * Normalizes a user-entered path to an absolute path, handling all common
  * terminal path styles:

package/dist/src/tui/import/steps/10-flow/support/preview-diff.d.ts

@@ -1,10 +1,7 @@
-import type { ChangeClassification, ComponentTypeSummary, PropertySummary } from '@contentful/experience-design-system-types';
+import type { ChangeClassification, ComponentTypeSummary } from '@contentful/experience-design-system-types';
 export interface PropertyDiffLine {
     key: string;
     color: 'green' | 'red' | 'yellow';
     text: string;
 }
 export declare function computeComponentDiffLines(current: ComponentTypeSummary, proposed: Record<string, unknown>, changeClassification?: ChangeClassification): PropertyDiffLine[];
-export declare function diffProperty(name: string, old: PropertySummary, newDef: Record<string, unknown>): PropertyDiffLine[];
-export declare function formatOldProp(prop: PropertySummary): string;
-export declare function formatPropDef(def: Record<string, unknown>): string;

package/dist/src/tui/import/steps/preview-validation-error/logic.d.ts

@@ -3,10 +3,7 @@ export interface PreviewValidationError {
     path: string;
     message: string;
 }
-export declare function failedComponentNames(errors: readonly PreviewValidationError[]): string[];
 export declare function matchedComponentNames(errors: readonly PreviewValidationError[], missingNames: readonly string[]): string[];
-export declare function formatErrorLine(error: PreviewValidationError): string;
 export declare function formatErrorLines(errors: readonly PreviewValidationError[]): string;
-export declare function missingNote(missingNames: readonly string[]): string;
 export declare function contextText(errors: readonly PreviewValidationError[], missingNames: readonly string[]): string;
 export declare function skipLabel(matchedNames: readonly string[]): string;

package/legacy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-0d4be259.0",
+  "version": "2.37.1-dev-build-c3f4df22.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-0d4be259.0",
+  "version": "2.37.1-dev-build-c3f4df22.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-0d4be259.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-0d4be259.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-c3f4df22.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-c3f4df22.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",