@contentful/experience-design-system-cli 2.37.1-dev-build-dbc9f30e.0 → 2.37.1-dev-build-8b126ca1.0

package/dist/package.json

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

package/dist/src/commands/import-options.d.ts

@@ -9,5 +9,4 @@ interface RawImportOptions {
     cache?: boolean;
 }
 export declare function toImportOptions(raw: RawImportOptions): ImportOptions;
-export declare function importOptionArgs(options: ImportOptions): string[];
 export {};

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

@@ -20,3 +20,8 @@ export interface ComponentSlotInfo {
 export declare function findSlotCycles(components: ComponentSlotInfo[]): SlotCycle[];
 export declare function suggestCycleBreakEdge(cycle: SlotCycle, allCycles: SlotCycle[]): SlotEdge;
 export declare function formatCyclePath(cycle: SlotCycle, maxHops?: number): string;
+export interface CyclePathSegment {
+    kind: 'component' | 'slot' | 'arrow';
+    text: string;
+}
+export declare function formatCyclePathSegments(cycle: SlotCycle, maxHops?: number): CyclePathSegment[];

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

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { ComponentRationale } from '@contentful/experience-design-system-backend-pipeline';
+export type ComponentRationalePanelProps = {
+    data: ComponentRationale;
+    scrollOffset: number;
+    width: number;
+    height: number;
+    active: boolean;
+};
+export declare function ComponentRationalePanel({ data, scrollOffset, width, height, active, }: ComponentRationalePanelProps): React.ReactElement;

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

@@ -0,0 +1,67 @@
+import React from 'react';
+import { findSlotCycles, type ComponentSlotInfo } from '../../07-scope-gate/graph/cycle-detection.js';
+type PropMetadata = {
+    rationale?: string | null;
+    sourceStartLine?: number | null;
+    sourceEndLine?: number | null;
+};
+export type FieldEditorMetadata = {
+    /** Absolute path to the component's source file. Null/undefined = unknown. */
+    sourcePath?: string | null;
+    /** Full source text of the component (used by the source-view panel). */
+    componentSource?: string | null;
+    /** Per-prop metadata keyed by prop name. */
+    props?: Record<string, PropMetadata>;
+};
+export type FieldEditorProps = {
+    value: string;
+    width: number;
+    height: number;
+    fixedHeight?: boolean;
+    active?: boolean;
+    onChange: (value: string) => void;
+    onSave: () => void;
+    onDiscard: () => void;
+    onExit?: () => void;
+    metadata?: FieldEditorMetadata;
+    onTogglePropRationale?: () => void;
+    propRationaleKey?: string;
+    onToggleComponentRationale?: () => void;
+    componentRationaleKey?: string;
+    onToggleSourceExternal?: () => void;
+    onTextEntryActiveChange?: (active: boolean) => void;
+    projectSlotGraph?: ComponentSlotInfo[];
+    currentComponentName?: string;
+    onDirtyChange?: (isDirty: boolean) => void;
+    discardTrigger?: number;
+    initialFocusTarget?: {
+        kind: 'description';
+    } | {
+        kind: 'prop' | 'slot';
+        name: string;
+    };
+    showHiddenProps?: boolean;
+    showInlineRationales?: boolean;
+    /** Pinned inside the box above the rows, in row and field-edit modes. Counts as `headerHeight` rows. */
+    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/FinalizeDialog.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
+/** Max removed-component lines shown at once; the rest scroll with arrow keys.
+ *  Exported so the parent's scroll-offset clamping stays in sync. */
+export declare const FINALIZE_REMOVED_WINDOW = 6;
+type FinalizeDialogProps = {
+    accepted: number;
+    rejected: number;
+    needsReview: number;
+    onConfirm: () => void;
+    onCancel: () => void;
+    /** Components that will be DELETED from the target space on push, from a
+     *  preview scoped to the accepted set. */
+    removed?: ComponentTypeSummary[];
+    /** Status of the accepted-set preview fired when the dialog opened. While
+     *  'running', the deletion section shows a spinner instead of a (stale) list. */
+    previewStatus?: 'idle' | 'running' | 'done' | 'error';
+    /** Scroll offset into the removed list (owned by the parent; arrow keys adjust it). */
+    removedScrollOffset?: number;
+};
+export declare function FinalizeDialog({ accepted, rejected, needsReview, onConfirm, onCancel, removed, previewStatus, removedScrollOffset, }: FinalizeDialogProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,9 @@
+import React from 'react';
+export type HighlightPart = {
+    text: string;
+    color?: string;
+    dim?: boolean;
+};
+export declare function HighlightedLine({ parts }: {
+    parts: readonly HighlightPart[];
+}): React.ReactElement;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+type JsonPanelProps = {
+    label: string;
+    value: string;
+    scrollOffset: number;
+    width: number;
+    height: number;
+    active: boolean;
+};
+export declare function JsonPanel({ label, value, scrollOffset, width, height, active }: JsonPanelProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { PreviewAnnotation } from '../types.js';
+import type { UseLivePreviewReturn } from '../use-live-preview.js';
+type LivePreviewSummaryProps = {
+    enabled: boolean;
+    previewAnnotations: ReadonlyMap<string, PreviewAnnotation>;
+    status: UseLivePreviewReturn['status'];
+    disabled: boolean;
+    spinner: string;
+    removedCount?: number;
+    showRemovedListHint?: boolean;
+};
+export declare function LivePreviewSummary({ enabled, previewAnnotations, status, disabled, spinner, removedCount, showRemovedListHint, }: LivePreviewSummaryProps): React.ReactElement | null;
+export {};

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

@@ -0,0 +1,8 @@
+import React from 'react';
+type QuitDialogProps = {
+    hasUnsavedDrafts: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+};
+export declare function QuitDialog({ hasUnsavedDrafts, onConfirm, onCancel }: QuitDialogProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,21 @@
+import React from 'react';
+export type RationaleLineData = {
+    kind: 'heading';
+    text: string;
+} | {
+    kind: 'text';
+    text: string;
+    dim?: boolean;
+} | {
+    kind: 'label';
+    text: string;
+    prefix?: string;
+    suffix?: string;
+    color?: string;
+} | {
+    kind: 'blank';
+};
+export declare function RationaleLine({ line, active }: {
+    line: RationaleLineData;
+    active: boolean;
+}): React.ReactElement;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+export type RationaleRow = {
+    name: string;
+    kind: 'prop' | 'slot';
+    rationale: string;
+};
+export type RationalePanelProps = {
+    componentName: string;
+    rows: RationaleRow[];
+    scrollOffset: number;
+    width: number;
+    height: number;
+    active: boolean;
+};
+export declare function RationalePanel({ componentName, rows, scrollOffset, width, height, active, }: RationalePanelProps): React.ReactElement;

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

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+import type { CdfReviewEntry } from '../types.js';
+import type { UseReviewEditorResult } from '../use-review-editor.js';
+import type { UseLivePreviewReturn } from '../use-live-preview.js';
+import { type ReviewDetailsEditorProps } from './ReviewDetailsEditor.js';
+type ReviewDetailsEditorConfig = Pick<ReviewDetailsEditorProps, 'componentRationale' | 'reviewMetadata' | 'reviewEditor' | 'width' | 'height' | 'sourceBorderColor' | 'jsonValue' | 'sidebarFocused' | 'fieldEditor'>;
+export type ReviewComponentPanelProps = ReviewDetailsEditorConfig & {
+    selectedKey: string;
+    selectedEntry: CDFComponentEntry;
+    saveError: string | null;
+    sidebarFooter?: React.ReactNode;
+    livePreview: Pick<UseLivePreviewReturn, 'status' | 'disabled'>;
+    livePreviewSpinner: string;
+};
+type ReviewFieldEditor = ReviewDetailsEditorProps['fieldEditor'];
+export declare function buildReviewFieldEditor(reviewEditor: UseReviewEditorResult, selectedJson: string, onExit: () => void, overrides?: Partial<ReviewFieldEditor>): ReviewFieldEditor;
+export declare function getReviewSelectionState(components: ReadonlyArray<CdfReviewEntry>, selectedIdx: number, showHiddenProps: boolean): {
+    selected: CdfReviewEntry | null;
+    selectedJson: string;
+    visibleJsonPanelValue: string;
+};
+export declare function ReviewEmptyComponentsWarning({ count, hidden, }: {
+    count: number;
+    hidden: boolean;
+}): React.ReactElement | null;
+export declare function ReviewNoSelection(): React.ReactElement;
+export declare function ReviewFinalizeError({ message, hidden, }: {
+    message: string | null;
+    hidden: boolean;
+}): React.ReactElement | null;
+export declare function ReviewComponentPanel({ selectedKey, selectedEntry, componentRationale, reviewMetadata, reviewEditor, width, height, sourceBorderColor, jsonValue, sidebarFocused, fieldEditor, saveError, sidebarFooter, livePreview, livePreviewSpinner, }: ReviewComponentPanelProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import { type FieldEditorProps } from './FieldEditor.js';
+import { type ReviewDetailsPanelProps } from '../review-details-panel.js';
+import type { UseReviewEditorResult } from '../use-review-editor.js';
+type ReviewEditorPanelState = Pick<UseReviewEditorResult, 'panelOpen' | 'panelScrollOffset' | 'tokenReviewRow' | 'tokenReviewEditing' | 'tokenReviewEditCursor' | 'tokenReviewEditSelection' | 'showJson' | 'jsonScrollOffset' | 'currentTokenSuggestions'>;
+export type ReviewDetailsEditorProps = Omit<ReviewDetailsPanelProps, 'editor' | 'panelOpen' | 'panelScrollOffset' | 'tokenSuggestions' | 'tokenReviewRow' | 'tokenReviewEditing' | 'tokenReviewEditCursor' | 'tokenReviewEditSelection' | 'showJson' | 'jsonScrollOffset'> & {
+    reviewEditor: ReviewEditorPanelState;
+    /** Drawn inside the editor box, above the rows, in both row and field-edit modes. */
+    header?: React.ReactNode;
+    fieldEditor: Omit<FieldEditorProps, 'active' | 'height' | 'metadata' | 'width'> & {
+        key?: string;
+    };
+};
+export declare function ReviewDetailsEditor({ selectedKey, componentRationale, reviewMetadata, width, height, sourceBorderColor, jsonValue, sidebarFocused, reviewEditor, fieldEditor, header, }: ReviewDetailsEditorProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,28 @@
+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>;
+    finalizePreview: UseFinalizePreviewReturn;
+    onFinalize: () => void;
+    onQuit: () => void;
+}): React.ReactElement;
+export declare function ReviewReloadDialog({ open }: {
+    open: boolean;
+}): React.ReactElement | null;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { ReviewComponentStatus } from '../types.js';
+export type ReviewStatusCounts = {
+    accepted: number;
+    rejected: number;
+    needsReview: number;
+};
+export type ReviewStatusEntry = {
+    status: ReviewComponentStatus;
+};
+export declare function countReviewStatuses(entries: ReadonlyArray<ReviewStatusEntry>): ReviewStatusCounts;
+export declare function ReviewLoadingState(): React.ReactElement;
+export declare function ReviewLoadError({ message }: {
+    message: string;
+}): React.ReactElement;

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

@@ -0,0 +1,14 @@
+import React from 'react';
+type ScrollablePanelProps = {
+    title: string;
+    width: number;
+    height: number;
+    active: boolean;
+    totalLines: number;
+    visibleStart: number;
+    visibleEnd: number;
+    borderColor?: string;
+    children: React.ReactNode;
+};
+export declare function ScrollablePanel({ title, width, height, active, totalLines, visibleStart, visibleEnd, borderColor, children, }: ScrollablePanelProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,30 @@
+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[];
+    selectedRow: number;
+    editing: boolean;
+    editCursor: number;
+    editSelection: Set<string>;
+    width: number;
+    height: number;
+    active: boolean;
+};
+export declare function TokenReviewPanel({ componentName, suggestions, selectedRow, editing, editCursor, editSelection, width, height, active, }: TokenReviewPanelProps): React.ReactElement;

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

@@ -0,0 +1,7 @@
+import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
+/** Header line for the removed-components surfaces (deletion panel + finalize
+ *  dialog). Kept in one place so both read identically. `withExpandHint` adds
+ *  the panel's "[d] to expand/collapse" affordance, which the dialog omits. */
+export declare function removedComponentsHeader(count: number, withExpandHint: boolean): string;
+/** One bullet line per removed component, matching the deletion panel. */
+export declare function removedComponentLine(rc: ComponentTypeSummary): string;

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

@@ -0,0 +1 @@
+export declare function wrapText(text: string, innerWidth: number): string[];

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

@@ -0,0 +1,37 @@
+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;
+    onFinalize: (accepted: number, rejected: number, unresolved: number) => void;
+    onQuit: () => void;
+    livePreview?: boolean;
+    spaceId?: string;
+    environmentId?: string;
+    cmaToken?: string;
+    host?: string;
+    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;

package/dist/src/tui/import/steps/09-review/graph/cycle-auto-reject.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentGraphNode } from '../../07-scope-gate/graph/composite-closure.js';
+export declare function computeCycleAutoRejectTargets(slotCycles: Array<{
+    path: string[];
+}>, graph: ComponentGraphNode[]): Set<string>;

package/dist/src/tui/import/steps/09-review/graph/cycle-view.d.ts

@@ -0,0 +1,7 @@
+import type { SlotCycle } from '../../07-scope-gate/graph/cycle-detection.js';
+import { type SlotGraphInput } from '../../07-scope-gate/graph/slot-graph.js';
+export interface CycleView {
+    pushBlocking: SlotCycle[];
+    structural: Set<string>;
+}
+export declare function computeCycleView(components: SlotGraphInput[]): CycleView;

package/dist/src/tui/import/steps/09-review/graph/issue-inheritance.d.ts

@@ -0,0 +1,8 @@
+import type { Closure, NodeStatus } from '../../07-scope-gate/graph/composite-closure.js';
+export interface RenderStatus {
+    status: NodeStatus;
+    isOwn: boolean;
+    sourceComponents: string[];
+}
+export declare function computeRenderStatuses(closure: Closure, directIssues: Map<string, NodeStatus>): Map<string, RenderStatus>;
+export declare function pickDrillTarget(ancestor: string, closure: Closure, directIssues: Map<string, NodeStatus>): string | null;

package/dist/src/tui/import/steps/09-review/graph/selection-cascade.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentGraphNode } from '../../07-scope-gate/graph/composite-closure.js';
+export declare function computeRejectCascade(target: string, components: ComponentGraphNode[]): Set<string>;
+export declare function computeAcceptCascade(target: string, components: ComponentGraphNode[]): Set<string>;

package/dist/src/tui/import/steps/09-review/helpers/auto-reject-decision.d.ts

@@ -0,0 +1,7 @@
+export interface AutoRejectDecisionInput {
+    loading: boolean;
+    autoRejectFired: boolean;
+    hasCycle: boolean;
+}
+export type AutoRejectDecision = 'fire' | 'skip';
+export declare function computeAutoRejectDecision(input: AutoRejectDecisionInput): AutoRejectDecision;

package/dist/src/tui/import/steps/09-review/helpers/breaking-change-format.d.ts

@@ -0,0 +1,2 @@
+import type { BreakingChange, ComponentTypeSummary } from '@contentful/experience-design-system-types';
+export declare function formatBreakingChange(bc: BreakingChange, current?: Pick<ComponentTypeSummary, 'fullProperties'>): string;

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

@@ -0,0 +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/helpers/enumerate-cycle-breaks.d.ts

@@ -0,0 +1,14 @@
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+import type { SlotCycle, SlotEdge } from '../../07-scope-gate/graph/cycle-detection.js';
+export type BreakEdge = SlotEdge;
+/** Row shape accepted by {@link enumerateCycleBreaks}. */
+export interface BreakEnumComponent {
+    key: string;
+    entry: CDFComponentEntry;
+}
+export declare function enumerateCycleBreaks(cycle: Pick<SlotCycle, 'edges'>, components: BreakEnumComponent[]): BreakEdge[];
+export declare function shouldBreakOverlayGoFullScreen({ rows, edgeCount, reservedChrome, }: {
+    rows: number;
+    edgeCount: number;
+    reservedChrome?: number;
+}): boolean;

package/dist/src/tui/import/steps/09-review/helpers/sidebar-width.d.ts

@@ -0,0 +1 @@
+export declare function computeSidebarWidth(terminalWidth: number): number;

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

@@ -0,0 +1,23 @@
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+import type { ReviewComponentStatus } from './types.js';
+export interface HistorySnapshot {
+    components: CdfReviewEntrySnapshot[];
+    autoRejected: string[];
+    undoSnapshot: Map<string, ReviewComponentStatus> | null;
+}
+interface CdfReviewEntrySnapshot {
+    key: string;
+    entry: CDFComponentEntry;
+    status: ReviewComponentStatus;
+}
+export interface HistoryStack {
+    push(snapshot: HistorySnapshot, label: string): void;
+    undo(): HistorySnapshot | null;
+    redo(): HistorySnapshot | null;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    reset(seed: HistorySnapshot): void;
+    size(): number;
+}
+export declare function createHistoryStack(seed: HistorySnapshot, maxDepth?: number): HistoryStack;
+export {};

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

@@ -0,0 +1,26 @@
+import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
+import type { PreviewAnnotation } from './types.js';
+/**
+ * Pure mapper from a `ServerPreviewResponse` to a per-component-name
+ * `PreviewAnnotation` map. Consumed by the wizard's final-review sidebar
+ * (and any other surface that wants to render diff badges next to a
+ * component row).
+ *
+ * The `new` bucket of `ServerPreviewResponse.components` is `CDFComponentEntry[]`
+ * — those entries do NOT carry a `name` field on the wire (the name is the
+ * KEY in the parent CDF document). So instead of trying to read names off
+ * entries, we derive the "new" set as:
+ *
+ *   new = localNames \ (unchangedNames ∪ changedNames ∪ removedNames)
+ *
+ * Callers must pass the local CDF document's component keys as `localNames`
+ * so we can perform the set difference. Removed components from the server
+ * that aren't in the local document are still annotated as `'removed'` (so
+ * the detail panel can list them).
+ *
+ * Precedence: `breaking` > `changed` > `removed` > `new`.
+ *
+ * Unchanged entries are omitted from the map — callers should treat
+ * `map.get(name) === undefined` as "no annotation".
+ */
+export declare function applyPreviewAnnotations(preview: ServerPreviewResponse, localNames: readonly string[]): Map<string, PreviewAnnotation>;

package/dist/src/tui/import/steps/09-review/review-details-panel.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { type TokenPropSuggestion } from './components/TokenReviewPanel.js';
+import type { ComponentRationale, ComponentReviewMetadata } from '@contentful/experience-design-system-backend-pipeline';
+type ReviewPanel = 'none' | 'prop-rationale' | 'component-rationale' | 'source' | 'token-review';
+export type ReviewDetailsPanelProps = {
+    selectedKey: string;
+    panelOpen: ReviewPanel;
+    componentRationale: ComponentRationale | null;
+    reviewMetadata: ComponentReviewMetadata | null;
+    panelScrollOffset: number;
+    width: number;
+    height: number;
+    sourceBorderColor?: string;
+    tokenSuggestions: TokenPropSuggestion[];
+    tokenReviewRow: number;
+    tokenReviewEditing: boolean;
+    tokenReviewEditCursor: number;
+    tokenReviewEditSelection: Set<string>;
+    showJson: boolean;
+    jsonValue: string;
+    jsonScrollOffset: number;
+    sidebarFocused: boolean;
+    editor: React.ReactNode;
+};
+export declare function ReviewDetailsPanel({ selectedKey, panelOpen, componentRationale, reviewMetadata, panelScrollOffset, width, height, sourceBorderColor, tokenSuggestions, tokenReviewRow, tokenReviewEditing, tokenReviewEditCursor, tokenReviewEditSelection, showJson, jsonValue, jsonScrollOffset, sidebarFocused, editor, }: ReviewDetailsPanelProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,39 @@
+import type { ImmediateInputKey } from '../07-scope-gate/sidebar/hooks/useImmediateInput.js';
+import type { UseReviewEditorResult } from './use-review-editor.js';
+type ReviewOverlayInputState = {
+    loading: boolean;
+    loadError: string | null;
+    showFinalize: boolean;
+    dialogOpen: boolean;
+    showHelp?: boolean;
+    showReloadDialog: boolean;
+    finalizePreview: {
+        scrollBy: (delta: number) => void;
+    };
+    reloadFromSave: () => void;
+    setShowReloadDialog: (open: boolean) => void;
+    onQuit: () => void;
+    handleUndo: () => void;
+    handleRedo: () => void;
+};
+export declare function handleReviewOverlayInput(input: string, key: ImmediateInputKey, state: ReviewOverlayInputState): boolean;
+type TokenReviewInputState = Pick<UseReviewEditorResult, 'panelOpen' | 'setPanelOpen' | 'tokenReviewRow' | 'setTokenReviewRow' | 'tokenReviewEditing' | 'setTokenReviewEditing' | 'tokenReviewEditCursor' | 'setTokenReviewEditCursor' | 'tokenReviewEditSelection' | 'setTokenReviewEditSelection' | 'currentTokenSuggestions' | 'handleTokenEditSave'>;
+type RationalePanelInputState = Pick<UseReviewEditorResult, 'panelOpen' | 'setPanelOpen' | 'panelScrollOffset' | 'setPanelScrollOffset'> & {
+    propKey: string;
+    componentKey: string;
+};
+export type ReviewPanelShortcutState = TokenReviewInputState & RationalePanelInputState & {
+    textEntryActive: boolean;
+    showJson: boolean;
+};
+export declare function handleReviewPanelShortcuts(input: string, key: ImmediateInputKey, state: ReviewPanelShortcutState): boolean;
+export type ReviewViewToggleInputState = Pick<UseReviewEditorResult, 'setShowJson' | 'setJsonScrollOffset' | 'pendingGRef'>;
+export declare function handleReviewViewToggleInput(input: string, state: ReviewViewToggleInputState): boolean;
+type JsonPanelInputState = Pick<UseReviewEditorResult, 'jsonScrollOffset' | 'setJsonScrollOffset' | 'pendingGRef'> & {
+    sidebarFocused: boolean;
+    showJson: boolean;
+    jsonValue: string;
+    height: number;
+};
+export declare function handleJsonPanelInput(input: string, key: ImmediateInputKey, state: JsonPanelInputState): boolean;
+export {};

package/dist/src/tui/import/steps/09-review/review-json-panel.d.ts

@@ -0,0 +1,7 @@
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+type ReviewJsonComponent = {
+    key: string;
+    entry: CDFComponentEntry;
+};
+export declare function getReviewJsonPanelValue(selected: ReviewJsonComponent | null, showHiddenProps: boolean): string;
+export {};