@contentful/experience-design-system-cli 2.37.1-dev-build-c24a406c.0 → 2.37.1-dev-build-76b10f7f.0

package/dist/package.json

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

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

@@ -5,22 +5,21 @@ export declare const IMPORT_TARGET_OPTIONS: ReadonlyArray<{
     label: string;
 }>;
 export declare function overviewFor(target: ImportTarget): readonly OverviewStep[];
-export type ImportStepId = 'inputs' | 'credentials' | 'component-extraction' | 'token-generation' | 'scope-gate' | 'generation' | 'review' | 'save-push';
+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[];
-    confirmed?: boolean;
 }
 /**
  * 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, 'inputs' | 'credentials'>;
+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. The paths stay, so the screen is not empty when it comes back.
+ * previous step's answer so that screen shows again.
  */
 export declare function goBack(target: ImportTarget, current: ImportStepId, answers: InputAnswers): {
     to: 'preflight';

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

@@ -0,0 +1,11 @@
+export declare const WELCOME_CONTROLS: readonly [{
+    readonly keys: "Enter";
+    readonly label: "Continue";
+}, {
+    readonly keys: "Ctrl+D";
+    readonly label: "Clear";
+}, {
+    readonly keys: "Esc";
+    readonly label: "Back";
+}];
+export declare function useWelcomeControls(onQuit: () => void): void;

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

@@ -0,0 +1,6 @@
+interface QuitKey {
+    escape: boolean;
+}
+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

@@ -0,0 +1,8 @@
+import React from 'react';
+interface WelcomeScreenProps {
+    onContinue: (projectPath: string) => void;
+    onQuit: () => void;
+    initialPath?: string;
+}
+export declare function WelcomeScreen({ onContinue, onQuit, initialPath }: WelcomeScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/02-token-input/controls.d.ts

@@ -0,0 +1,11 @@
+export declare const TOKEN_INPUT_CONTROLS: readonly [{
+    readonly keys: "Enter";
+    readonly label: "Continue";
+}, {
+    readonly keys: "Ctrl+D";
+    readonly label: "Clear";
+}, {
+    readonly keys: "Esc";
+    readonly label: "Back";
+}];
+export declare function useTokenInputControls(onBack: () => void): void;

package/dist/src/tui/import/steps/02-token-input/logic.d.ts

@@ -0,0 +1,6 @@
+interface Key {
+    escape: boolean;
+}
+export declare function shouldGoBack(key: Key): boolean;
+export declare function toTokenPath(value: string): string | null;
+export {};

package/dist/src/tui/import/steps/02-token-input/screen.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface TokenInputScreenProps {
+    onConfirm: (tokensPath: string) => void;
+    onBack: () => void;
+    initialPath?: string;
+}
+export declare function TokenInputScreen({ onConfirm, onBack, initialPath }: TokenInputScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/03-path-validation/controls.d.ts

@@ -0,0 +1,13 @@
+import { type PathPhase } from './logic.js';
+interface Control {
+    keys: string;
+    label: string;
+}
+interface PathValidationHandlers {
+    onConfirm: () => void;
+    onChangePath: () => void;
+    onBack: () => void;
+}
+export declare function controlsFor(phase: PathPhase): readonly Control[];
+export declare function usePathValidationControls(phase: PathPhase, handlers: PathValidationHandlers): void;
+export {};

package/dist/src/tui/import/steps/{01-inputs → 03-path-validation}/helpers/scan-files.d.ts

@@ -1,2 +1,2 @@
-import type { ScanResult } from '../scan-logic.js';
+import type { ScanResult } from '../logic.js';
 export declare function scanFiles(directory: string): ScanResult;

package/dist/src/tui/import/steps/{01-inputs/scan-logic.d.ts → 03-path-validation/logic.d.ts}

@@ -12,7 +12,9 @@ export type ScanResult = {
     ok: false;
     failure: ScanFailureCode;
 };
-interface SummaryRow {
+export type PathPhase = 'scanning' | 'ready' | 'failed';
+export type KeyAction = 'confirm' | 'change-path' | 'back';
+export interface SummaryRow {
     label: string;
     count: number;
     tone: 'default' | 'accent' | 'muted';
@@ -26,6 +28,10 @@ export interface FailureMessage {
     headline: string;
     hints: string[];
 }
+interface Key {
+    escape: boolean;
+    return: boolean;
+}
 export declare function describeFailure(failure: ScanFailureCode, path: string): FailureMessage;
 /**
  * The scan result as rows and a warning. When the import does not generate tokens (components only), `.json` files are
@@ -34,4 +40,6 @@ export declare function describeFailure(failure: ScanFailureCode, path: string):
 export declare function summarize(counts: FileCounts, { hasTokens }?: {
     hasTokens?: boolean;
 }): Summary;
+export declare function phaseOf(scan: ScanResult | undefined): PathPhase;
+export declare function keyAction(phase: PathPhase, input: string, key: Key): KeyAction | undefined;
 export {};

package/dist/src/tui/import/steps/03-path-validation/screen.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface PathValidationScreenProps {
+    projectPath: string;
+    onConfirm: (result: {
+        projectPath: string;
+        filePaths: string[];
+    }) => void;
+    onChangePath: () => void;
+    onBack: () => void;
+    /** False when the import does not generate tokens, so `.json` files are not described as design tokens. */
+    hasTokens?: boolean;
+}
+export declare function PathValidationScreen({ projectPath, onConfirm, onChangePath, onBack, hasTokens, }: PathValidationScreenProps): React.ReactElement;
+export {};

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

@@ -1,4 +1,6 @@
 export { PreflightScreen } from './00-preflight/screen.js';
-export { InputsScreen } from './01-inputs/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 { 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-c24a406c.0",
+  "version": "2.37.1-dev-build-76b10f7f.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-c24a406c.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-c24a406c.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-76b10f7f.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-76b10f7f.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

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

@@ -1,12 +0,0 @@
-import type { ImportTarget } from '../00-preflight/logic.js';
-import { type FileCounts } from './scan-logic.js';
-export type InputField = 'projectPath' | 'tokensPath';
-export type InputValues = Record<InputField, string>;
-/** The paths a mode asks for. A mode never shows the one it does not use. */
-export declare function fieldsFor(target: ImportTarget): readonly InputField[];
-export declare function trimmed(value: string): string | null;
-/** The scan as one line, such as "167 files: 6 .tsx files · 100 .json files (design tokens)", and the warning if any. */
-export declare function describeScan(counts: FileCounts, hasTokens: boolean): {
-    line: string;
-    warning?: string;
-};

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

@@ -1,17 +0,0 @@
-import React from 'react';
-import type { ImportTarget } from '../00-preflight/logic.js';
-import { type InputValues } from './logic.js';
-interface InputsResult {
-    projectPath?: string;
-    tokensPath?: string;
-    scannedFiles?: string[];
-}
-interface InputsScreenProps {
-    target: ImportTarget;
-    /** What an earlier visit or the saved settings already hold. */
-    initial?: Partial<InputValues>;
-    onConfirm: (result: InputsResult) => void;
-    onBack: () => void;
-}
-export declare function InputsScreen({ target, initial, onConfirm, onBack }: InputsScreenProps): React.ReactElement;
-export {};

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

@@ -1,50 +0,0 @@
-import React from 'react';
-export interface SetupMenuItem<C extends string> {
-    /** `edit` is reserved: choosing it turns the rows below into inputs. */
-    choice: C;
-    label: string;
-    /** What choosing it does, shown dimmed after the label. */
-    description: string;
-}
-export interface SetupField<K extends string> {
-    key: K;
-    label: string;
-    /** Shows dots instead of the value, for secrets. */
-    masked?: boolean;
-    /** Shown dimmed in the value's place while it is empty. */
-    hint?: string;
-    /** What is known about the value, such as the result of checking it. Shown under the row. */
-    note?: React.ReactNode;
-}
-interface SetupFormProps<K extends string, C extends string> {
-    title: string;
-    subtitle?: string;
-    menu: readonly SetupMenuItem<C>[];
-    /** The heading over the values, which sit under a divider and are not part of the menu. */
-    dataTitle: string;
-    fields: readonly SetupField<K>[];
-    values: Record<K, string>;
-    /** Called on every keystroke while a field is open. */
-    onChange: (key: K, value: string) => void;
-    /** Called when the last field is done, so the caller can check what was entered. */
-    onCommit: () => void;
-    /** Called when editing is cancelled with Esc, so the caller can put the earlier values back. */
-    onCancel: () => void;
-    onEditStart?: () => void;
-    onChoose: (choice: Exclude<C, 'edit'>) => void;
-    /** What Esc does from the menu. */
-    onEscape: () => void;
-    /** Opens with the fields already editable, for a step with nothing to review yet. */
-    initialEditing?: boolean;
-    /** Ignores keys while something is in flight. */
-    busy?: boolean;
-    /** Shown under the values, for read-only content that belongs to the same screen. */
-    children?: React.ReactNode;
-}
-/**
- * The layout the setup steps share. A menu of actions sits on top and the values sit below a divider. `Edit` does not
- * change screens: the same rows become inputs where they are, the menu stays put (dimmed), and finishing the last field
- * puts the cursor back on the first menu item.
- */
-export declare function SetupForm<K extends string, C extends string>({ title, subtitle, menu, dataTitle, fields, values, onChange, onCommit, onCancel, onEditStart, onChoose, onEscape, initialEditing, busy, children, }: SetupFormProps<K, C>): React.ReactElement;
-export {};