@contentful/experience-design-system-cli 2.37.1-dev-build-12711902.0 → 2.37.1-dev-build-aa3ffe6f.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-12711902.0",
+  "version": "2.37.1-dev-build-aa3ffe6f.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/{legacy/dist/src/import/tui → dist/src/tui/import/steps/09-review}/components/LivePreviewSummary.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import type { PreviewAnnotation } from '../../../analyze/select/types.js';
-import type { UseLivePreviewReturn } from '../useLivePreview.js';
+import type { PreviewAnnotation } from '../types.js';
+import type { UseLivePreviewReturn } from '../use-live-preview.js';
 type LivePreviewSummaryProps = {
     enabled: boolean;
     previewAnnotations: ReadonlyMap<string, PreviewAnnotation>;

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/{legacy/dist/src/import/tui → dist/src/tui/import/steps/09-review}/components/ReviewComponentPanel.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-import type { CdfReviewEntry } from '../hooks/useReviewSession.js';
-import type { UseReviewEditorResult } from '../hooks/useReviewEditor.js';
-import type { UseLivePreviewReturn } from '../useLivePreview.js';
+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 & {

package/{legacy/dist/src/import/tui → dist/src/tui/import/steps/09-review}/components/ReviewDetailsEditor.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { type FieldEditorProps } from '../../../analyze/select/tui/components/FieldEditor.js';
-import { type ReviewDetailsPanelProps } from '../steps/review-details-panel.js';
-import type { UseReviewEditorResult } from '../hooks/useReviewEditor.js';
+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;

package/{legacy/dist/src/import/tui → dist/src/tui/import/steps/09-review}/components/ReviewDialogs.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
-import type { UseFinalizePreviewReturn } from '../useFinalizePreview.js';
-import type { UseReviewSurfaceStateResult } from '../hooks/useReviewSurfaceState.js';
+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;

package/{legacy/dist/src/import/tui → dist/src/tui/import/steps/09-review}/components/ReviewStatus.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { ReviewComponentStatus } from '../../../analyze/select/types.js';
+import type { ReviewComponentStatus } from '../types.js';
 export type ReviewStatusCounts = {
     accepted: number;
     rejected: number;

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/{legacy/dist/src/import/tui/steps/GenerateReviewStep.d.ts → dist/src/tui/import/steps/09-review/generate-review-step.d.ts}

@@ -17,7 +17,7 @@ export declare function sortComponentsForSidebar<T extends {
     key: string;
     entry: CDFComponentEntry;
 }>(components: T[], cycleParticipants?: Set<string>): T[];
-export { computeCycleAutoRejectTargets } from '../../cycle-auto-reject.js';
+export { computeCycleAutoRejectTargets } from './graph/cycle-auto-reject.js';
 export interface BreakingComponent {
     componentName: string;
     changes: BreakingChange[];

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

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

package/{legacy/dist/src/analyze → dist/src/tui/import/steps/09-review/graph}/cycle-view.d.ts

@@ -1,5 +1,5 @@
-import type { SlotCycle } from './cycle-detection.js';
-import { type SlotGraphInput } from './slot-graph.js';
+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>;

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/{legacy/dist/src/import/tui/steps → dist/src/tui/import/steps/09-review/helpers}/enumerate-cycle-breaks.d.ts

@@ -1,5 +1,5 @@
 import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-import type { SlotCycle, SlotEdge } from '../../../analyze/cycle-detection.js';
+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 {

package/{legacy/dist/src/import/tui → dist/src/tui/import/steps/09-review}/history.d.ts

@@ -1,5 +1,5 @@
 import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-import type { ReviewComponentStatus } from '../../analyze/select/types.js';
+import type { ReviewComponentStatus } from './types.js';
 export interface HistorySnapshot {
     components: CdfReviewEntrySnapshot[];
     autoRejected: string[];

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/{legacy/dist/src/import/tui/steps → dist/src/tui/import/steps/09-review}/review-details-panel.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { type TokenPropSuggestion } from '../../../analyze/select/tui/components/TokenReviewPanel.js';
-import type { ComponentRationale, ComponentReviewMetadata } from '../../../session/db.js';
+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;

package/{legacy/dist/src/import/tui/hooks → dist/src/tui/import/steps/09-review}/review-input.d.ts

@@ -1,5 +1,5 @@
-import type { ImmediateInputKey } from '../../../analyze/select/tui/hooks/useImmediateInput.js';
-import type { UseReviewEditorResult } from './useReviewEditor.js';
+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;

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

@@ -0,0 +1,30 @@
+/**
+ * Pure helper for computing the next scroll offset when the operator presses
+ * a navigation key inside a scrollable TUI panel (JSON view, rationale view,
+ * etc.). Extracted as a shared module so multiple panels can reuse the same
+ * scroll bindings without duplicating logic.
+ *
+ * Returns the new offset, or `null` if the input doesn't match any scroll
+ * binding (caller should NOT update state in that case).
+ *
+ * Supported bindings:
+ * - downArrow          → +1 line
+ * - upArrow            → -1 line
+ * - Ctrl+d             → +half-page (floor(panelHeight / 2))
+ * - Ctrl+u             → -half-page
+ * - PageDown           → +panelHeight
+ * - PageUp             → -panelHeight
+ * - G                  → jump to maxOffset
+ *
+ * `j`/`k` are intentionally not handled here because they are field-navigation
+ * keys in the editor. `g` (single-tap) and `gg` (double-tap → jump to 0) are handled separately
+ * by the caller via a pending-flag ref, since they need transient state.
+ */
+export type ScrollKeyState = {
+    upArrow?: boolean;
+    downArrow?: boolean;
+    pageUp?: boolean;
+    pageDown?: boolean;
+    ctrl?: boolean;
+};
+export declare function computeNextScrollOffset(current: number, input: string, key: ScrollKeyState, totalLines: number, panelHeight: number): number | null;

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

@@ -0,0 +1,26 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { HistorySnapshot } from './history.js';
+import type { CdfReviewEntry, ReviewComponentStatus, TokenReviewToken } from './types.js';
+export type ReviewSessionLoadResult<TExtra = undefined> = {
+    entries: CdfReviewEntry[];
+    tokens: TokenReviewToken[];
+    error: string | null;
+    extra?: TExtra;
+};
+export type ReviewSessionLoaderOptions<TExtra = undefined> = {
+    extractSessionId: string;
+    tokenSessionId?: string | null;
+    loadExtra?: (db: DatabaseSync, sessionId: string) => TExtra;
+    sortEntries: (entries: CdfReviewEntry[], extra: TExtra | undefined) => CdfReviewEntry[];
+};
+export declare function loadReviewSessionState<TExtra = undefined>({ extractSessionId, tokenSessionId, loadExtra, sortEntries, }: ReviewSessionLoaderOptions<TExtra>): ReviewSessionLoadResult<TExtra>;
+export declare function createReviewHistorySnapshot(components: CdfReviewEntry[], options?: {
+    autoRejected?: readonly string[];
+    undoSnapshot?: ReadonlyMap<string, ReviewComponentStatus> | null;
+}): HistorySnapshot;
+export type ReviewFinalizeCounts = {
+    accepted: number;
+    rejected: number;
+    unresolved: number;
+};
+export declare function finalizeReviewSession(extractSessionId: string, components: CdfReviewEntry[]): ReviewFinalizeCounts;

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

@@ -0,0 +1,9 @@
+export declare const PALETTE: {
+    readonly info: "#1773EB";
+    readonly success: "#00C459";
+    readonly error: "#E44F20";
+    readonly warning: "#FFDA00";
+    readonly muted: "#8B8D91";
+    readonly border: "#C4D1DE";
+    readonly inverse: "#FFFFFF";
+};

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

@@ -0,0 +1,8 @@
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+import type { TokenPropSuggestion, TokenReviewToken } from './types.js';
+/**
+ * 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[];

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

@@ -0,0 +1,19 @@
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+export type ReviewComponentStatus = 'needs-review' | 'reviewed' | 'accepted' | 'rejected';
+export type CdfReviewEntry = {
+    key: string;
+    entry: CDFComponentEntry;
+    status: ReviewComponentStatus;
+};
+export type ReviewPanel = 'none' | 'prop-rationale' | 'component-rationale' | 'source' | 'token-review';
+export type TokenReviewToken = {
+    path: string;
+    kind: string;
+};
+export type TokenPropSuggestion = {
+    propName: string;
+    paths: string[];
+    suggested: string[];
+    allowed: string[];
+};
+export type PreviewAnnotation = 'new' | 'changed' | 'removed' | 'breaking';

package/{legacy/dist/src/import/tui/hooks/useReviewEditor.d.ts → dist/src/tui/import/steps/09-review/use-review-editor.d.ts}

@@ -1,7 +1,5 @@
 import { type Dispatch, type SetStateAction } from 'react';
-import { type TokenPropSuggestion, type TokenReviewToken } from '../../../analyze/select/tui/components/TokenReviewPanel.js';
-import type { CdfReviewEntry } from './useReviewSession.js';
-export type ReviewPanel = 'none' | 'prop-rationale' | 'component-rationale' | 'source' | 'token-review';
+import type { CdfReviewEntry, ReviewPanel, TokenPropSuggestion, TokenReviewToken } from './types.js';
 type UseReviewEditorOptions = {
     components: CdfReviewEntry[];
     selectedIdx: number;

package/{legacy/dist/src/import/tui/hooks/useReviewPreview.d.ts → dist/src/tui/import/steps/09-review/use-review-preview.d.ts}

@@ -1,6 +1,6 @@
 import type { ComponentTypeSummary, ServerPreviewResponse } from '@contentful/experience-design-system-types';
-import type { PreviewAnnotation } from '../../../analyze/select/types.js';
-import { type UseLivePreviewReturn } from '../useLivePreview.js';
+import type { PreviewAnnotation } from './types.js';
+import { type UseLivePreviewReturn } from './use-live-preview.js';
 export type UseReviewPreviewOptions = {
     components: ReadonlyArray<{
         key: string;

package/{legacy/dist/src/import/tui/hooks/useReviewSession.d.ts → dist/src/tui/import/steps/09-review/use-review-session.d.ts}

@@ -1,28 +1,8 @@
-import type { DatabaseSync } from 'node:sqlite';
 import { type Dispatch, type SetStateAction } from 'react';
-import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-import { type ComponentRationale, type ComponentReviewMetadata } from '../../../session/db.js';
-import { type TokenReviewToken } from '../../../analyze/select/tui/components/TokenReviewPanel.js';
-import type { ReviewComponentStatus } from '../../../analyze/select/types.js';
-import { type HistorySnapshot } from '../history.js';
-export type CdfReviewEntry = {
-    key: string;
-    entry: CDFComponentEntry;
-    status: ReviewComponentStatus;
-};
-export type ReviewSessionLoadResult<TExtra = undefined> = {
-    entries: CdfReviewEntry[];
-    tokens: TokenReviewToken[];
-    error: string | null;
-    extra?: TExtra;
-};
-export type ReviewSessionLoaderOptions<TExtra = undefined> = {
-    extractSessionId: string;
-    tokenSessionId?: string | null;
-    loadExtra?: (db: DatabaseSync, sessionId: string) => TExtra;
-    sortEntries: (entries: CdfReviewEntry[], extra: TExtra | undefined) => CdfReviewEntry[];
-};
-export declare function loadReviewSessionState<TExtra = undefined>({ extractSessionId, tokenSessionId, loadExtra, sortEntries, }: ReviewSessionLoaderOptions<TExtra>): ReviewSessionLoadResult<TExtra>;
+import { type ComponentRationale, type ComponentReviewMetadata } from '@contentful/experience-design-system-backend-pipeline';
+import { type HistorySnapshot } from './history.js';
+import { type ReviewSessionLoadResult } from './session.js';
+import type { CdfReviewEntry, TokenReviewToken } from './types.js';
 type UseReviewSessionOptions<TExtra> = {
     loadSession: () => ReviewSessionLoadResult<TExtra>;
     tokensPath?: string;
@@ -46,10 +26,6 @@ export declare function useReviewMetadata({ components, selectedIdx, extractSess
     reviewMetadata: ComponentReviewMetadata | null;
     componentRationale: ComponentRationale | null;
 };
-export declare function createReviewHistorySnapshot(components: CdfReviewEntry[], options?: {
-    autoRejected?: readonly string[];
-    undoSnapshot?: ReadonlyMap<string, ReviewComponentStatus> | null;
-}): HistorySnapshot;
 type UseReviewHistoryOptions = {
     loading: boolean;
     components: CdfReviewEntry[];
@@ -65,12 +41,6 @@ export declare function useReviewHistory({ loading, components, createSnapshot,
     handleRedo: () => void;
     resetHistory: (snapshot: HistorySnapshot) => void;
 };
-export type ReviewFinalizeCounts = {
-    accepted: number;
-    rejected: number;
-    unresolved: number;
-};
-export declare function finalizeReviewSession(extractSessionId: string, components: CdfReviewEntry[]): ReviewFinalizeCounts;
 export type UseReviewFinalizeOptions = {
     showFinalize: boolean;
     extractSessionId: string;
@@ -89,7 +59,7 @@ export type UseReviewFinalizeOptions = {
  * final counts back to the wizard.
  */
 export declare function useReviewFinalize({ showFinalize, extractSessionId, tokensPath, spaceId, environmentId, cmaToken, host, components, onFinalize, }: UseReviewFinalizeOptions): {
-    finalizePreview: import("../useFinalizePreview.js").UseFinalizePreviewReturn;
+    finalizePreview: import("./use-finalize-preview.js").UseFinalizePreviewReturn;
     handleFinalizeConfirm: () => void;
 };
 export {};

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

@@ -0,0 +1,21 @@
+import type { ImportHandoff } from '@contentful/experience-design-system-types/handoff';
+import type { ExtractionInput } from '../../06-extraction/types.js';
+import type { FlowStart } from './controller.js';
+interface SavedCredentials {
+    spaceId?: string;
+    environmentId?: string;
+    cmaToken?: string;
+    host?: string;
+}
+/**
+ * What the flow starts from. The credentials are the ones the user confirmed. When they skipped validation there are none
+ * to use, so the saved ones stand in, which is what the wizard did: it always read them from the store. The review's
+ * live preview and the push use them.
+ */
+export declare function buildFlowStart(input: {
+    extraction: ExtractionInput;
+    handoff: ImportHandoff;
+    saved?: SavedCredentials;
+    generatePromptPath?: string;
+}): FlowStart;
+export {};