@contentful/experience-design-system-cli 2.37.1-dev-build-2aacedbd.0 → 2.37.1-dev-build-c24a406c.0

package/dist/package.json

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

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

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

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

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

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

@@ -0,0 +1,12 @@
+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/{03-path-validation/logic.d.ts → 01-inputs/scan-logic.d.ts}

@@ -12,8 +12,7 @@ export type ScanResult = {
     ok: false;
     failure: ScanFailureCode;
 };
-export type PathPhase = 'scanning' | 'ready' | 'failed';
-export interface SummaryRow {
+interface SummaryRow {
     label: string;
     count: number;
     tone: 'default' | 'accent' | 'muted';
@@ -35,5 +34,4 @@ 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 {};

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

@@ -0,0 +1,17 @@
+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/import/steps/index.d.ts

@@ -1,6 +1,4 @@
 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 { InputsScreen } from './01-inputs/screen.js';
 export { CredentialsScreen } from './04-credentials/screen.js';
 export { ExtractionScreen } from './06-extraction/screen.js';

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

@@ -0,0 +1,50 @@
+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 {};

package/package.json

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

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

@@ -1 +0,0 @@
-export declare function toProjectPath(value: string): string | null;

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

@@ -1,8 +0,0 @@
-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/logic.d.ts

@@ -1 +0,0 @@
-export declare function toTokenPath(value: string): string | null;

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

@@ -1,8 +0,0 @@
-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/screen.d.ts

@@ -1,14 +0,0 @@
-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/shared/components/MenuScreen.d.ts

@@ -1,34 +0,0 @@
-import React from 'react';
-export interface MenuItem<C extends string> {
-    choice: C;
-    label: string;
-    /** What choosing it does, shown dimmed after the label. */
-    description: string;
-}
-interface MenuRow {
-    label: string;
-    /** Shown bold; an empty value shows "(empty)". */
-    value: string;
-}
-interface MenuScreenProps<C extends string> {
-    title: string;
-    subtitle?: string;
-    menu: readonly MenuItem<C>[];
-    /** Read-only values shown under the menu, lined up with it. */
-    rows?: readonly MenuRow[];
-    onChoose: (choice: C) => void;
-    /** What Esc does. */
-    onEscape: () => void;
-    /** The heading over the read-only part, which sits under a divider and is never focusable. */
-    dataTitle?: string;
-    /** Ignores keys while something is in flight. */
-    busy?: boolean;
-    /** Shown after the rows, for read-only content that belongs to the same screen. */
-    children?: React.ReactNode;
-}
-/**
- * The layout the setup steps share: a title, a menu of actions on top, the read-only data below it and the key hints.
- * Values are never edited here; an `Edit` item opens the step's own input instead.
- */
-export declare function MenuScreen<C extends string>({ title, subtitle, menu, rows, onChoose, onEscape, dataTitle, busy, children, }: MenuScreenProps<C>): React.ReactElement;
-export {};

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

@@ -1,28 +0,0 @@
-import React from 'react';
-type PathCheck = {
-    ok: true;
-    path: string;
-} | {
-    ok: false;
-    error: string;
-    resolvedPath?: string;
-};
-interface PathStepScreenProps {
-    title: string;
-    subtitle: string;
-    /** The label of the read-only value and of the input, such as "Project path". */
-    label: string;
-    initialPath?: string;
-    /** Trims the typed value; null when nothing was entered. */
-    toPath: (value: string) => string | null;
-    /** Runs when Continue is chosen. Its path is handed on; its error is shown under the path. */
-    check: (path: string) => PathCheck;
-    onContinue: (path: string) => void;
-    onBack: () => void;
-}
-/**
- * A step that asks for one path. A path that is already known opens read-only with the menu above it, like the
- * credentials step; with none yet it opens straight in the input. `Edit` opens the input and Enter returns to the menu.
- */
-export declare function PathStepScreen({ title, subtitle, label, initialPath, toPath, check, onContinue, onBack, }: PathStepScreenProps): React.ReactElement;
-export {};