@contentful/experience-design-system-cli 2.37.1-dev-build-350476b2.0 → 2.37.1-dev-build-f137cd4b.0

package/dist/package.json

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

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,17 @@
+export type ImportTarget = 'both' | 'tokens' | 'components';
+export declare const IMPORT_TARGET_OPTIONS: ReadonlyArray<{
+    target: ImportTarget;
+    label: string;
+    description: 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[];
+/** The screen Back goes to from `current`: the one before it in this mode, or the preflight from the first step. */
+export declare function previousStep(target: ImportTarget, current: ImportStepId): ImportStepId | 'preflight';
+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/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/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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-350476b2.0",
+  "version": "2.37.1-dev-build-f137cd4b.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-350476b2.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-350476b2.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-f137cd4b.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-f137cd4b.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 {};