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

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

@@ -1,3 +1,10 @@
+/** 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
@@ -5,6 +12,23 @@
  * 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;
@@ -13,6 +37,18 @@ 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 { type ComponentSlotInfo } from '../../07-scope-gate/graph/cycle-detection.js';
+import { findSlotCycles, type ComponentSlotInfo } from '../../07-scope-gate/graph/cycle-detection.js';
 type PropMetadata = {
     rationale?: string | null;
     sourceStartLine?: number | null;
@@ -46,5 +46,22 @@ 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,7 +1,21 @@
 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,15 +1,21 @@
 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,4 +1,5 @@
 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;
@@ -12,5 +13,25 @@ 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,4 +1,8 @@
+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,4 +1,7 @@
 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';
-type UseFinalizePreviewOptions = {
+export type UseFinalizePreviewOptions = {
     /** True while the Finalize dialog is open. Toggling true (re)fires the preview. */
     open: boolean;
     extractSessionId: string | null;
@@ -26,4 +26,14 @@ 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,8 +1,9 @@
+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 FlowState } from './types.js';
+import { type FlowPatch, 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;
@@ -46,6 +47,12 @@ export interface FlowDeps {
 }
 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 { patchReviewStateWithValidationErrors } from '@contentful/experience-design-system-backend-pipeline';
+import { ApiError, patchReviewStateWithValidationErrors, type PreviewValidationError } 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,6 +30,20 @@ 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,7 +1,16 @@
 import type { DatabaseSync } from 'node:sqlite';
 import { appendRun, buildSourceFingerprint } from '@contentful/experience-design-system-backend-pipeline';
-import { type DTCGTokenEntry } from '@contentful/experience-design-system-types';
+import { type CDFComponentEntry, type CDFDocument, 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

@@ -9,5 +9,9 @@ interface FlowScreenProps {
     /** Leaves the import with the exit code the wizard would have exited with. */
     onExit: (exitCode: number) => 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, }: FlowScreenProps): React.ReactElement;
 export {};

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

@@ -1,5 +1,11 @@
 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,3 +1,8 @@
+/**
+ * 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,7 +1,10 @@
-import type { ChangeClassification, ComponentTypeSummary } from '@contentful/experience-design-system-types';
+import type { ChangeClassification, ComponentTypeSummary, PropertySummary } 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,7 +3,10 @@ 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/dist/src/tui/settings/contentful-configuration/config-store.d.ts

@@ -5,6 +5,7 @@ export type V1Credentials = {
     host?: string;
     defaultComponentDir?: string;
     defaultTokenFile?: string;
+    contentfulBaseDir?: string;
     [key: string]: string | undefined;
 };
 export declare function readCredentials(): Promise<V1Credentials>;

package/legacy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-c3f4df22.0",
+  "version": "2.37.1-dev-build-6bfb243f.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-c3f4df22.0",
+  "version": "2.37.1-dev-build-6bfb243f.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-c3f4df22.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-c3f4df22.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-6bfb243f.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-6bfb243f.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",