@contentful/experience-design-system-cli 2.37.1-dev-build-04aa2aa0.0 → 2.37.1-dev-build-758ea601.0

package/dist/package.json

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

package/dist/src/tui/control-hints.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+export declare function ControlHints({ hints }: {
+    hints: readonly {
+        keys: string;
+        label: string;
+    }[];
+}): React.ReactElement;

package/dist/src/tui/import/shared/gate-step/gate-step.d.ts

@@ -1,5 +1,4 @@
 import React from 'react';
-import { type StepHeaderProps } from '@tui/shared/components/StepHeader.js';
 interface GateStepProps {
     message: string;
     onContinue: () => void;
@@ -10,7 +9,6 @@ interface GateStepProps {
     skipLabel?: string;
     onSkip?: () => void;
     intent?: 'success' | 'error';
-    step?: StepHeaderProps['step'];
 }
-export declare function GateStep({ message, onContinue, onQuit, summary, context, continueLabel, skipLabel, onSkip, intent, step, }: GateStepProps): React.ReactElement;
+export declare function GateStep({ message, onContinue, onQuit, summary, context, continueLabel, skipLabel, onSkip, intent, }: GateStepProps): React.ReactElement;
 export {};

package/dist/src/tui/import/shared/running-step/logic.d.ts

@@ -9,3 +9,4 @@ export interface RunningLine {
 }
 export declare function progressPercent(progress: Progress): number;
 export declare function formatElapsed(totalSeconds: number): string;
+export declare function stepLabel(stepNumber: number, totalSteps: number, title: string): string;

package/dist/src/tui/import/shared/running-step/running-step.d.ts

@@ -1,10 +1,11 @@
 import React from 'react';
 import { type RunningLine } from './logic.js';
-import type { ImportStepId } from '@tui/shared/components/StepHeader.js';
 interface RunningStepProps {
-    step: ImportStepId;
+    stepNumber: number;
+    totalSteps: number;
+    title: string;
     description: string;
     lines?: readonly RunningLine[];
 }
-export declare function RunningStep({ step, description, lines, }: RunningStepProps): React.ReactElement;
+export declare function RunningStep({ stepNumber, totalSteps, title, description, lines, }: RunningStepProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/00-preflight/controls.d.ts

@@ -0,0 +1,17 @@
+import { type ImportTarget } from './logic.js';
+export declare const PREFLIGHT_CONTROLS: readonly [{
+    readonly keys: "↑/↓";
+    readonly label: "Choose";
+}, {
+    readonly keys: "Enter";
+    readonly label: "Continue";
+}, {
+    readonly keys: "Esc";
+    readonly label: "Back to menu";
+}];
+export declare function usePreflightControls(handlers: {
+    focus: number;
+    onFocus: (focus: number) => void;
+    onChoose: (target: ImportTarget) => void;
+    onQuit: () => void;
+}): void;

package/dist/src/tui/import/steps/00-preflight/logic.d.ts

@@ -0,0 +1,43 @@
+export type ImportTarget = 'both' | 'tokens' | 'components';
+export declare const IMPORT_TARGET_OPTIONS: ReadonlyArray<{
+    target: ImportTarget;
+    label: string;
+}>;
+export type ImportStepId = 'project' | 'token-file' | 'path-validation' | 'credentials' | 'component-extraction' | 'token-generation' | 'scope-gate' | 'generation' | 'review' | 'save-push';
+export declare function stepsFor(target: ImportTarget): readonly ImportStepId[];
+export interface InputAnswers {
+    projectPath?: string;
+    tokensPath?: string;
+    scannedFiles?: string[];
+}
+/**
+ * The input screen to show: the first step of this mode whose answer is still missing, or 'credentials' once every
+ * earlier one is answered. A mode never shows a screen it does not list, so skipping one needs no special case.
+ */
+export declare function currentInputStep(target: ImportTarget, answers: InputAnswers): Extract<ImportStepId, 'project' | 'token-file' | 'path-validation' | 'credentials'>;
+/**
+ * What Back from `current` does: leave for the preflight when it is the first screen of the mode, otherwise clear the
+ * previous step's answer so that screen shows again.
+ */
+export declare function goBack(target: ImportTarget, current: ImportStepId, answers: InputAnswers): {
+    to: 'preflight';
+} | {
+    to: 'step';
+    answers: InputAnswers;
+};
+/**
+ * Where a run writes its files when it has no project to put them in: the Root Project Directory setting if there is
+ * one, otherwise the folder the token file is in. Components runs always have a project and use it.
+ */
+export declare function runBaseDir(input: {
+    projectPath?: string;
+    tokensPath?: string;
+    configuredBaseDir?: string;
+}): string;
+interface FocusKey {
+    upArrow: boolean;
+    downArrow: boolean;
+}
+/** The option focused after a key: arrows move through the list and wrap around. */
+export declare function moveFocus(focus: number, key: FocusKey, count: number): number;
+export {};

package/dist/src/tui/import/steps/00-preflight/screen.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type ImportTarget } from './logic.js';
+interface PreflightScreenProps {
+    onChoose: (target: ImportTarget) => void;
+    onQuit: () => void;
+}
+export declare function PreflightScreen({ onChoose, onQuit }: PreflightScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/01-welcome/controls.d.ts

@@ -6,6 +6,6 @@ export declare const WELCOME_CONTROLS: readonly [{
     readonly label: "Clear";
 }, {
     readonly keys: "Esc";
-    readonly label: "Back to menu";
+    readonly label: "Back";
 }];
 export declare function useWelcomeControls(onQuit: () => void): void;

package/dist/src/tui/import/steps/01-welcome/logic.d.ts

@@ -1,6 +1,14 @@
+import type { ImportTarget } from '../00-preflight/logic.js';
 interface QuitKey {
     escape: boolean;
 }
+interface OverviewStep {
+    description: string;
+    /** Whether the step uses the user's local AI agent. */
+    ai: boolean;
+}
+/** The steps the user is about to go through, as the welcome screen lists them, for what they chose to generate. */
+export declare function overviewFor(target: ImportTarget): readonly OverviewStep[];
 export declare function shouldQuit(key: QuitKey): boolean;
 export declare function toProjectPath(value: string): string | null;
 export {};

package/dist/src/tui/import/steps/01-welcome/screen.d.ts

@@ -1,8 +1,10 @@
 import React from 'react';
+import type { ImportTarget } from '../00-preflight/logic.js';
 interface WelcomeScreenProps {
+    target: ImportTarget;
     onContinue: (projectPath: string) => void;
     onQuit: () => void;
     initialPath?: string;
 }
-export declare function WelcomeScreen({ onContinue, onQuit, initialPath }: WelcomeScreenProps): React.ReactElement;
+export declare function WelcomeScreen({ target, onContinue, onQuit, initialPath, }: WelcomeScreenProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/05-token-reuse/logic.d.ts

@@ -13,10 +13,3 @@ interface InspectInput {
     cache: boolean;
 }
 export declare function inspectTokens({ rawTokensPath, contentfulDir, cache }: InspectInput): Promise<TokensState>;
-export declare function gateText({ tokensPath, sourceChanged }: {
-    tokensPath: string;
-    sourceChanged: boolean;
-}): {
-    summary: string;
-    context?: string;
-};

package/dist/src/tui/import/steps/06-extraction/logic.d.ts

@@ -20,6 +20,19 @@ export declare function progressRows(progress: ExtractionProgress, agent: string
 }>;
 /** True when every job is already done, so the screen would only flash. The wizard shows nothing in this case. */
 export declare function isFullCacheHit(progress: ExtractionProgress): boolean;
+/**
+ * The wizard's step counts: three fixed steps, one more when there is a token stage, two more when components are
+ * imported, and one more when the tokens can be mapped (not known yet at this stage, so it adds nothing here).
+ * Extraction is step 2 when there is a token stage, otherwise step 1.
+ */
+export declare function stepNumbers(input: {
+    hasRawTokens: boolean;
+    skipComponents?: boolean;
+    mapTokensEligible?: boolean | null;
+}): {
+    stepNumber: number;
+    totalSteps: number;
+};
 export declare function noComponentsMessage(projectPath: string): string;
 export declare function agentAuthMessage(agent: string, status: 'not-found' | 'unauthenticated'): string;
 /**

package/dist/src/tui/import/steps/06-extraction/run-tokens-only.d.ts

@@ -0,0 +1,31 @@
+import { checkAgentAuth, runGenerateTokensSession } from '@contentful/experience-design-system-backend-pipeline';
+export interface TokensOnlyInput {
+    rawTokensPath: string;
+    /** Where tokens.json is written: this import run's folder. */
+    outDir: string;
+    agent: string;
+    agentModel?: string;
+    promptOverrides: string[];
+    noCache: boolean;
+}
+export type TokensOnlyResult = {
+    ok: true;
+    tokensPath: string;
+    tokenSessionId: string | null;
+    tokenCount: number;
+} | {
+    ok: false;
+    step: 'generate tokens' | `${string} auth check`;
+    message: string;
+};
+/** The outside world the stage talks to, so it can be tested without an agent. */
+export interface TokensOnlyDeps {
+    checkAgentAuth: typeof checkAgentAuth;
+    runGenerateTokensSession: typeof runGenerateTokensSession;
+}
+/**
+ * The extraction stage for an import that only generates tokens: the same auth check and token generation the full stage
+ * runs, without scanning components, composing them or selecting. The full stage fails when it finds no components, so it
+ * cannot be used for this.
+ */
+export declare function runTokensOnly(input: TokensOnlyInput, deps?: TokensOnlyDeps): Promise<TokensOnlyResult>;

package/dist/src/tui/import/steps/06-extraction/screen.d.ts

@@ -3,6 +3,8 @@ import type { ExtractionProgress } from './types.js';
 interface ExtractionScreenProps {
     progress: ExtractionProgress;
     agent: string;
+    stepNumber: number;
+    totalSteps: number;
 }
-export declare function ExtractionScreen({ progress, agent }: ExtractionScreenProps): React.ReactElement;
+export declare function ExtractionScreen({ progress, agent, stepNumber, totalSteps, }: ExtractionScreenProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/06-extraction/use-tokens-only.d.ts

@@ -0,0 +1,12 @@
+import { type TokensOnlyInput, type TokensOnlyResult } from './run-tokens-only.js';
+export type TokensOnlyState = {
+    status: 'running';
+} | {
+    status: 'done';
+    result: TokensOnlyResult;
+};
+/**
+ * Runs the tokens-only stage once for the given input. Passing nothing leaves it idle. A run that finishes after the
+ * input changed or the screen went away is ignored.
+ */
+export declare function useTokensOnly(input: TokensOnlyInput | undefined): TokensOnlyState | undefined;

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

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare function legendEntry(keyBracket: string, label: string, active?: boolean): React.ReactElement;

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

@@ -25,10 +25,6 @@ export interface FixedPanelProps {
 export declare function FixedPanel({ width, height, minHeight, focused, borderStyle, borderColor, paddingLeft, clipOverflow, children, }: FixedPanelProps): ReactElement;
 /** Shared frame for panels whose viewport must not change with their contents. */
 export declare function WindowedPanel({ width, height, title, focused, children }: WindowedPanelProps): ReactElement;
-export declare function WindowFooter({ above, below }: {
-    above: number;
-    below: number;
-}): ReactElement;
 export declare function WindowIndicator({ direction, count }: {
     direction: WindowDirection;
     count: number;

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

@@ -0,0 +1,8 @@
+export declare const PALETTE: {
+    readonly info: "#40a0ff" | "#0059c8";
+    readonly success: "#5DB057" | "#006D23";
+    readonly error: "#ff707d" | "#bd002a";
+    readonly warning: "#FFC835" | "#CC4500";
+    readonly muted: "#aec1cc" | "#5A657C";
+    readonly border: "#aec1cc" | "#5A657C";
+};

package/dist/src/tui/import/steps/08-generation/screen.d.ts

@@ -5,6 +5,8 @@ interface GenerationScreenProps {
     agent: string;
     acceptedCount: number;
     hasTokens: boolean;
+    stepNumber: number;
+    totalSteps: number;
 }
-export declare function GenerationScreen({ progress, agent, acceptedCount, hasTokens, }: GenerationScreenProps): React.ReactElement;
+export declare function GenerationScreen({ progress, agent, acceptedCount, hasTokens, stepNumber, totalSteps, }: GenerationScreenProps): React.ReactElement;
 export {};

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

@@ -0,0 +1,8 @@
+import React from 'react';
+type StepHeaderProps = {
+    stepNumber: number;
+    totalSteps: number;
+    title: string;
+};
+export declare function StepHeader({ stepNumber, totalSteps, title }: StepHeaderProps): React.ReactElement;
+export {};

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

@@ -17,5 +17,6 @@ export declare function buildFlowStart(input: {
     handoff: ImportHandoff;
     saved?: SavedCredentials;
     generatePromptPath?: string;
+    tokensOnly?: FlowStart['tokensOnly'];
 }): FlowStart;
 export {};

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

@@ -17,6 +17,13 @@ export interface FlowStart {
         cmaToken: string;
         host: string;
     };
+    /** Set when the import only generates tokens: there is no extraction or generation, so the flow starts at saving. */
+    tokensOnly?: {
+        tokensPath: string;
+        tokenSessionId: string | null;
+        tokenCount: number;
+        outDir: string;
+    };
     /** A custom prompt for `generate components`, shown as a warning above every step. */
     generatePromptPath?: string;
 }

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

@@ -1,7 +1,9 @@
 import React from 'react';
 import type { PushProgress } from '../support/push-progress.js';
 type PushingStepProps = {
+    stepNumber: number;
+    totalSteps: number;
     progress: PushProgress;
 };
-export declare function PushingStep({ progress }: PushingStepProps): React.ReactElement;
+export declare function PushingStep({ stepNumber, totalSteps, progress }: PushingStepProps): React.ReactElement;
 export {};

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

@@ -4,9 +4,11 @@ type WizardPreviewStepProps = {
     preview: ServerPreviewResponse;
     spaceId: string;
     environmentId: string;
+    stepNumber: number;
+    totalSteps: number;
     onConfirm: (acknowledge: boolean) => void;
     onEdit?: () => void;
     onQuit: () => void;
 };
-export declare function WizardPreviewStep({ preview, spaceId, environmentId, onConfirm, onEdit, onQuit, }: WizardPreviewStepProps): React.ReactElement;
+export declare function WizardPreviewStep({ preview, spaceId, environmentId, stepNumber, totalSteps, onConfirm, onEdit, onQuit, }: WizardPreviewStepProps): React.ReactElement;
 export {};

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

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

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

@@ -1,6 +1,6 @@
+export { PreflightScreen } from './00-preflight/screen.js';
 export { WelcomeScreen } from './01-welcome/screen.js';
 export { TokenInputScreen } from './02-token-input/screen.js';
 export { PathValidationScreen } from './03-path-validation/screen.js';
 export { CredentialsScreen } from './04-credentials/screen.js';
-export { TokenReuseScreen } from './05-token-reuse/screen.js';
 export { ExtractionScreen } from './06-extraction/screen.js';

package/dist/src/tui/theme.d.ts

@@ -5,7 +5,6 @@ export declare const PALETTE: {
     readonly muted: "#aec1cc";
     readonly border: "#aec1cc";
     readonly accent: "#40a0ff";
-    readonly onAccent: "#111B2B";
     readonly error: "#ff707d";
     readonly success: "#5DB057";
     readonly warning: "#FFC835";
@@ -14,7 +13,6 @@ export declare const PALETTE: {
     readonly muted: "#5A657C";
     readonly border: "#5A657C";
     readonly accent: "#0059c8";
-    readonly onAccent: "#FFFFFF";
     readonly error: "#bd002a";
     readonly success: "#006D23";
     readonly warning: "#CC4500";

package/package.json

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

package/dist/src/tui/import/steps/05-token-reuse/screen.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-interface TokenReuseScreenProps {
-    tokensPath: string;
-    sourceChanged: boolean;
-    onReuse: () => void;
-    onRegenerate: () => void;
-    onQuit: () => void;
-}
-export declare function TokenReuseScreen({ tokensPath, sourceChanged, onReuse, onRegenerate, onQuit, }: TokenReuseScreenProps): React.ReactElement;
-export {};

package/dist/src/tui/shared/components/ControlHints.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-export interface ControlHint {
-    keys: string;
-    label: string;
-    active?: boolean;
-}
-export declare function ControlHints({ hints }: {
-    hints: readonly ControlHint[];
-}): React.ReactElement;

package/dist/src/tui/shared/components/StepHeader.d.ts

@@ -1,26 +0,0 @@
-import React from 'react';
-declare const IMPORT_STEPS: readonly [{
-    readonly id: "setup";
-    readonly label: "Setup";
-}, {
-    readonly id: "extraction";
-    readonly label: "Extract";
-}, {
-    readonly id: "scope-gate";
-    readonly label: "Select";
-}, {
-    readonly id: "generation";
-    readonly label: "Generate";
-}, {
-    readonly id: "review";
-    readonly label: "Review";
-}, {
-    readonly id: "push";
-    readonly label: "Push";
-}];
-export type ImportStepId = (typeof IMPORT_STEPS)[number]['id'];
-export interface StepHeaderProps {
-    step: ImportStepId | 'done';
-}
-export declare function StepHeader({ step }: StepHeaderProps): React.ReactElement;
-export {};