@contentful/experience-design-system-cli 2.34.5-dev-build-13ecfbdc.0 → 2.34.5-dev-build-5cd8bcd6.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.34.5-dev-build-13ecfbdc.0",
+  "version": "2.34.5-dev-build-5cd8bcd6.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/analyze/composition/resolve-mapping-cli.d.ts

@@ -1,6 +1,8 @@
 export type CompositionCliOptions = {
     /** `--composition-refresh` — force edge emission to run even over resolved residue. */
     compositionRefresh?: boolean;
+    /** `--no-cache` — force the composition agent to rerun with the rest of the pipeline. */
+    noCache?: boolean;
 };
 export type ResolvedCompositionSources = {
     forceAgent: boolean;

package/dist/src/analyze/extract-command.d.ts

@@ -1,3 +1,7 @@
 import type { Command } from 'commander';
+export declare function resolveExtractNoCache(opts: {
+    cache?: boolean;
+    noCache?: boolean;
+}): boolean;
 export declare function collectSourceFiles(directory: string, onProgress?: (scannedCount: number) => void): Promise<string[]>;
 export declare function registerInternalExtractCommand(program: Command): void;

package/dist/src/analyze/select/tui/components/FieldEditor.d.ts

@@ -40,6 +40,7 @@ export type FieldEditorProps = {
         name: string;
     };
     showHiddenProps?: boolean;
+    showInlineRationales?: boolean;
 };
 export declare function simulateGraphWithCandidate(projectSlotGraph: ComponentSlotInfo[], selfName: string, currentSlots: {
     name: string;
@@ -58,5 +59,5 @@ export declare function computeAllowedComponentReplacementCandidates(projectSlot
     name: string;
     allowedComponents: string[];
 }[], targetSlotName: string, replaceIndex: number): string[];
-export declare function FieldEditor({ value, width, height, active, onChange, onSave, onDiscard, onExit, metadata, onTogglePropRationale, propRationaleKey, onToggleComponentRationale, componentRationaleKey, onToggleSourceExternal, onTextEntryActiveChange, projectSlotGraph, currentComponentName, onDirtyChange, discardTrigger, initialFocusTarget, showHiddenProps, }: FieldEditorProps): React.ReactElement;
+export declare function FieldEditor({ value, width, height, active, onChange, onSave, onDiscard, onExit, metadata, onTogglePropRationale, propRationaleKey, onToggleComponentRationale, componentRationaleKey, onToggleSourceExternal, onTextEntryActiveChange, projectSlotGraph, currentComponentName, onDirtyChange, discardTrigger, initialFocusTarget, showHiddenProps, showInlineRationales, }: FieldEditorProps): React.ReactElement;
 export {};

package/dist/src/analyze/select/tui/components/GroupedSidebar.d.ts

@@ -17,6 +17,9 @@ export interface GroupedSidebarProps {
     expandedGroups: Set<string>;
     onToggleExpanded: (rootName: string) => void;
     width: number;
+    height?: number;
+    title?: string;
+    wrapLabels?: boolean;
     focused: boolean;
     renderStatusByKey?: Map<string, RenderStatus>;
     previewAnnotationByKey?: Map<string, PreviewAnnotation>;

package/dist/src/analyze/select/tui/components/HelpOverlay.d.ts

@@ -10,10 +10,12 @@ type HelpOverlayProps = {
     mode: 'analyze' | 'validate' | 'review';
     sections?: undefined;
     onClose: () => void;
+    handleInput?: boolean;
 } | {
     mode?: undefined;
     sections: HelpSection[];
     onClose: () => void;
+    handleInput?: boolean;
 };
 export declare function HelpOverlay(props: HelpOverlayProps): React.ReactElement;
 export {};

package/dist/src/analyze/select/tui/components/Sidebar.d.ts

@@ -7,8 +7,9 @@ export type PreviewBadgeValue = {
     bold?: boolean;
     dim?: boolean;
 };
-export declare function PreviewBadge({ badge }: {
+export declare function PreviewBadge({ badge, highlighted, }: {
     badge: PreviewBadgeValue | null;
+    highlighted?: boolean;
 }): React.ReactElement;
 type SidebarProps = {
     components: ReviewComponentSummary[];

package/dist/src/analyze/select/tui/hooks/scroll-offset.d.ts

@@ -8,15 +8,16 @@
  * binding (caller should NOT update state in that case).
  *
  * Supported bindings:
- * - j / downArrow      → +1 line
- * - k / upArrow        → -1 line
+ * - 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
  *
- * `g` (single-tap) and `gg` (double-tap → jump to 0) are handled separately
+ * `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 = {

package/dist/src/analyze/select/tui/hooks/useImmediateInput.d.ts

@@ -16,4 +16,4 @@ export type ImmediateInputKey = {
     meta: boolean;
 };
 export type ImmediateInputHandler = (input: string, key: ImmediateInputKey) => void;
-export declare function useImmediateInput(handler: ImmediateInputHandler): void;
+export declare function useImmediateInput(handler: ImmediateInputHandler, enabled?: boolean): void;

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { CDFDocument, CDFComponentEntry, DTCGTokenEntry } from '@contentful/experience-design-system-types';
+import { type AgentAuthStatus } from '@contentful/experience-design-system-generation';
 export declare function buildGenerateComponentsArgs(opts: {
     sessionId: string;
     tokensPath?: string;
@@ -59,5 +60,6 @@ export type WizardAppProps = {
     generatePromptPath?: string;
     skipMapTokens?: boolean;
     initialRawTokensPath?: string;
+    initialAgentAuth?: Promise<AgentAuthStatus>;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, initialAgentAuth, }?: WizardAppProps): React.ReactElement;

package/dist/src/import/tui/components/CompactControlBar.d.ts

@@ -0,0 +1,4 @@
+export declare function CompactControlBar({ hasGroupRoots, searchActive }: {
+    hasGroupRoots: boolean;
+    searchActive: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/src/import/tui/lineage-layout.d.ts

@@ -1,15 +1,15 @@
-/** Sidebar height (rows) — unchanged whether or not the panel is open. */
-export declare const VISIBLE_COUNT = 20;
-/** Panel window ceiling (matches LineagePanel's DEFAULT_MAX_ROWS from L2b). */
-export declare const MAX_PANEL_ROWS = 15;
+/** 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
- * assume enough height for the FULL sidebar (BASE_CHROME_OVERHEAD + the full
- * VISIBLE_COUNT) so the non-interactive render is complete and unclipped.
+ * assume enough height for a terminal-sized sidebar so the non-interactive
+ * render is complete and unclipped.
  */
 export declare const FALLBACK_ROWS = 40;
 /**
@@ -22,16 +22,13 @@ 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 "✓ Extraction complete" + "Found N…" intro, the counter
- * strip (with its blank separator), the cycle banner, the nothing-selected /
+ * 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. Measured via the PTY
- * harness against the react-ux-matrix fixture (cycles present = a tall case):
- * the base frame was 39 lines with a 20-row sidebar after the legend row-gap
- * compression, i.e. ≈19 lines of chrome. We use 20 for a one-line safety
- * margin so the total frame stays strictly within `stdout.rows`.
+ * 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 = 20;
+export declare const BASE_CHROME_OVERHEAD = 18;
 export interface LineageLayoutInput {
     /** Terminal height in rows (`stdout.rows`, or the fallback). */
     rows: number;
@@ -48,9 +45,8 @@ export interface LineageLayout {
 }
 /**
  * The sidebar height is constant (the panel replaces it in the same slot, so
- * there is nothing to shrink). When the panel is open its entry window is sized
- * to fit the sidebar's footprint AND the terminal — never taller than the
- * sidebar was, so opening lineage cannot grow the frame past `rows`.
+ * 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 {
@@ -61,12 +57,9 @@ export interface SidebarBudget {
 }
 /**
  * L2e — autoscale the BASE frame to the terminal height. Even with the lineage
- * panel closed, a fixed 20-row sidebar plus the always-on chrome can exceed a
- * small terminal's rows, so plain Ink (no alt-screen) full-repaints (`\x1b[2J`)
- * on every cursor move = flicker. This sizes the sidebar's visible-row budget
- * from `stdout.rows` minus `BASE_CHROME_OVERHEAD` so the whole frame fits at
- * 24/30/40 rows, and unifies the panel-open sizing with `computeLineageLayout`
- * so BOTH cases stay within the terminal.
+ * panel closed, the visible-row budget follows `stdout.rows` minus
+ * `BASE_CHROME_OVERHEAD` so the whole frame stays within the terminal while
+ * preserving the shared panel-open sizing behavior.
  *
  * Floor: `BASE_CHROME_OVERHEAD + SIDEBAR_MIN`. Below it `SIDEBAR_MIN`
  * (usability) intentionally wins over the fit — a terminal that small can't

package/dist/src/import/tui/run-selection-agent.d.ts

@@ -5,4 +5,5 @@ export declare function runSelectionAgent(options: {
     model?: string;
     promptText?: string;
     promptPath?: string;
+    noCache?: boolean;
 }): Promise<void>;

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

@@ -4,23 +4,29 @@ export interface ScopeComponentLike {
     name: string;
 }
 export type Decision = 'accepted' | 'rejected' | 'undecided';
+export declare const SCOPE_GATE_MAIN_COLUMN_WIDTH = 54;
+export declare const ACCEPTED_COMPONENTS_COLUMN_WIDTH = 36;
+export interface ScopeGatePanelLayout {
+    height: number;
+    mainVisibleCount: number;
+    sideVisibleCount: number;
+}
+/**
+ * All scope-gate panels share one terminal-sized frame. Panels with a header
+ * therefore receive the same content rows because every scope-gate panel has
+ * the same header and indicator chrome.
+ */
+export declare function computePanelLayout(mainVisibleCount: number): ScopeGatePanelLayout;
 export declare function computeColumnWidths(totalWidth: number): {
-    layout: 'single' | 'three-column';
+    layout: 'single' | 'two-column';
     main: number;
     added: number;
-    groups: number;
 };
 export interface AddedComponentEntry {
     name: string;
     isCycle: boolean;
 }
-export interface AddedGroupEntry {
-    name: string;
-    depCount: number;
-    isCycle: boolean;
-}
 export declare function buildAddedComponentsList(components: ScopeComponentLike[], stateByKey: Map<string, Decision>, cycleParticipants?: Set<string>): AddedComponentEntry[];
-export declare function buildAddedGroupsList(closures: Map<string, Closure>, stateByKey: Map<string, Decision>, cycleParticipants?: Set<string>, cycleUnits?: Map<string, Set<string>>): AddedGroupEntry[];
 export declare function computeCounters(components: ScopeComponentLike[], closures: Map<string, Closure>, stateByKey: Map<string, Decision>): {
     accepted: number;
     rejected: number;

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

@@ -14,12 +14,15 @@ type CredentialsStepProps = {
      * (Change 1 of the wizard prefetch refactor).
      */
     validating?: boolean;
+    /** Background validation of unchanged prefilled credentials; input remains editable. */
+    backgroundValidating?: boolean;
     /** Inline status describing in-flight background generation prefetch. */
     generatePrefetchStatus?: 'idle' | 'running' | 'complete' | 'failed';
     /** Error message from a failed generation prefetch (rendered as a banner). */
     generatePrefetchError?: string | null;
     /** Called when the user submits with any field changed from its initial value */
     onConfirm: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
+    onValuesChange?: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
     /** Called when the user submits without changing any field (use existing creds as-is) */
     onContinue?: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
     onQuit: () => void;
@@ -36,5 +39,5 @@ type CredentialsStepProps = {
      */
     onSkip?: () => void;
 };
-export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, validating, generatePrefetchStatus, generatePrefetchError, onConfirm, onContinue, onQuit, onRetryPrefetch, onSkip, }: CredentialsStepProps): React.ReactElement;
+export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, validating, backgroundValidating, generatePrefetchStatus, generatePrefetchError, onConfirm, onValuesChange, onContinue, onQuit, onRetryPrefetch, onSkip, }: CredentialsStepProps): React.ReactElement;
 export {};

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

@@ -2,7 +2,7 @@ import React from 'react';
 type GateStepProps = {
     successMessage: string;
     summary?: string;
-    context: string;
+    context?: string;
     continueLabel?: string;
     skipLabel?: string;
     onContinue: () => void;

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

@@ -5,9 +5,20 @@ type RunningStepProps = {
     title: string;
     description: string;
     detail?: string;
+    detailComplete?: boolean;
     /** Optional second progress line (own spinner) — e.g. composition resolution
      *  running after the file scan on the extracting screen. */
     secondaryDetail?: string;
+    secondaryComplete?: boolean;
+    /** Optional third progress line for another concurrent stage. */
+    tertiaryDetail?: string;
+    tertiaryComplete?: boolean;
+    /** Optional fourth progress line for another concurrent stage. */
+    quaternaryDetail?: string;
+    quaternaryComplete?: boolean;
+    /** Optional fifth progress line for another concurrent stage. */
+    quinaryDetail?: string;
+    quinaryComplete?: boolean;
 };
-export declare function RunningStep({ stepNumber, totalSteps, title, description, detail, secondaryDetail, }: RunningStepProps): React.ReactElement;
+export declare function RunningStep({ stepNumber, totalSteps, title, description, detail, detailComplete, secondaryDetail, secondaryComplete, tertiaryDetail, tertiaryComplete, quaternaryDetail, quaternaryComplete, quinaryDetail, quinaryComplete, }: RunningStepProps): React.ReactElement;
 export {};

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

@@ -5,6 +5,7 @@ export interface PreviewDiffLine {
     color: string;
     text: string;
 }
+export declare function buildPreviewSummaryLines(preview: ServerPreviewResponse): PreviewDiffLine[];
 export declare function buildPreviewDiffLines(preview: ServerPreviewResponse): PreviewDiffLine[];
 type WizardPreviewStepProps = {
     preview: ServerPreviewResponse;

package/dist/src/import/tui/wizard-state-transitions.d.ts

@@ -6,6 +6,12 @@ export declare function nextStepAfterScopeGate(opts: {
 export declare function nextStepAfterCredentialsValidated(opts: {
     acceptedCount: number;
 }): WizardStepAfterCredentials;
+export declare function shouldGenerateAfterScopeGate(opts: {
+    acceptedCount: number;
+}): boolean;
+export declare function shouldGenerateAfterCredentialsValidated(opts: {
+    acceptedCount: number;
+}): boolean;
 export declare function shouldSkipFinalReviewAfterCredentials(state: {
     generateSessionId: string | null;
     finalReviewPassed: boolean;
@@ -17,7 +23,7 @@ export declare function shouldBypassPreview(state: {
     credentialsSkipped: boolean;
 }): boolean;
 export declare function buildSkippedPreviewTransition(): {
-    step: 'push-decision-gate';
+    step: 'print-gate';
     serverPreview: null;
 };
 export type CycleGateAction = 'block' | 'proceed';