@contentful/experience-design-system-cli 2.37.1-dev-build-845e7310.0 → 2.37.1-dev-build-923f560a.0

package/dist/package.json

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

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

@@ -1,4 +1,3 @@
 export { ErrorStep } from './error-step/error-step.js';
 export { GateStep } from './gate-step/gate-step.js';
-export { OverviewBox, type OverviewStep } from './overview-box/overview-box.js';
 export { RunningStep } from './running-step/running-step.js';

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";
+    readonly label: "Back to menu";
 }];
 export declare function useWelcomeControls(onQuit: () => void): void;

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

@@ -1,11 +1,8 @@
 import React from 'react';
-import { type OverviewStep } from '../../shared/index.js';
 interface TokenInputScreenProps {
     onConfirm: (tokensPath: string) => void;
     onBack: () => void;
     initialPath?: string;
-    /** The steps of the import, shown above the prompt when this is the first screen the user sees (tokens only). */
-    overview?: readonly OverviewStep[];
 }
-export declare function TokenInputScreen({ onConfirm, onBack, initialPath, overview, }: TokenInputScreenProps): React.ReactElement;
+export declare function TokenInputScreen({ onConfirm, onBack, initialPath }: TokenInputScreenProps): React.ReactElement;
 export {};

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

@@ -33,13 +33,7 @@ interface Key {
     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
- * not design tokens here, so the row says they are ignored and the warnings do not mention tokens.
- */
-export declare function summarize(counts: FileCounts, { hasTokens }?: {
-    hasTokens?: boolean;
-}): Summary;
+export declare function summarize(counts: FileCounts): 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

@@ -7,8 +7,6 @@ interface PathValidationScreenProps {
     }) => 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 declare function PathValidationScreen({ projectPath, onConfirm, onChangePath, onBack, }: PathValidationScreenProps): React.ReactElement;
 export {};

package/dist/src/tui/import/steps/04-credentials/logic.d.ts

@@ -1,11 +1,6 @@
 export declare const FIELDS: readonly ["spaceId", "environmentId", "cmaToken", "host"];
 export type CredentialField = (typeof FIELDS)[number];
 export type CredentialValues = Record<CredentialField, string>;
-/**
- * Why the space is asked for. Components are looked up in it before they are generated, so that is part of the reason
- * unless the import only generates tokens, which has nothing to look up.
- */
-export declare function credentialsPurpose(tokensOnly: boolean): string;
 interface Key {
     escape: boolean;
     tab: boolean;

package/dist/src/tui/import/steps/04-credentials/screen.d.ts

@@ -12,8 +12,6 @@ interface CredentialsScreenProps {
     onBack: () => void;
     initial?: Partial<CredentialValues>;
     validate?: (values: CredentialValues) => Promise<ValidationResult>;
-    /** The import only generates tokens, so there are no components to look up in the space. */
-    tokensOnly?: boolean;
 }
-export declare function CredentialsScreen({ onDone, onBack, initial, validate, tokensOnly, }: CredentialsScreenProps): React.ReactElement;
+export declare function CredentialsScreen({ onDone, onBack, initial, validate, }: CredentialsScreenProps): React.ReactElement;
 export {};

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

@@ -0,0 +1,22 @@
+export type { TokenStrategy } from '../06-extraction/types.js';
+export type TokensState = {
+    kind: 'none';
+} | {
+    kind: 'cached';
+    tokensPath: string;
+    sourceChanged: boolean;
+};
+interface InspectInput {
+    rawTokensPath: string;
+    /** The `.contentful` folder: the sessions' `dsi-import` folders sit inside it, and an older `tokens.json` may sit in it. */
+    contentfulDir: string;
+    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/05-token-reuse/screen.d.ts

@@ -0,0 +1,10 @@
+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/import/steps/06-extraction/logic.d.ts

@@ -4,11 +4,13 @@ import type { ExtractionProgress } from './types.js';
 export type ProgressEvent = ExtractAndComposeProgress;
 /**
  * Every job the stage will run starts on the first frame, so no row appears later as a surprise. A job that does not
- * apply stays 'idle' and has no row: existing entities need credentials, and token definitions need a raw tokens file.
+ * apply stays 'idle' and has no row: existing entities need credentials, token definitions need a raw tokens file, and
+ * reused tokens are already complete.
  */
 export declare function initialProgress(input: {
     hasCredentials: boolean;
     hasRawTokens: boolean;
+    reuseTokens: boolean;
 }): ExtractionProgress;
 export declare function applyProgressEvent(progress: ExtractionProgress, event: ProgressEvent): ExtractionProgress;
 /** The rows the screen shows, in the order the wizard showed them. Rows that do not apply are left out. */

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

@@ -1,12 +1,15 @@
-import type { ExtractionHandoff } from '@contentful/experience-design-system-types/handoff';
+import type { ExtractionHandoff, ImportHandoff } from '@contentful/experience-design-system-types/handoff';
+export type TokenStrategy = ImportHandoff['tokens']['strategy'];
 export interface ExtractionInput {
     projectPath: string;
     /** Where the stage writes tokens.json and the other files. Defaults to `<projectPath>/.contentful`. */
     outDir?: string;
     /** Absolute source files from the path-validation step (collectFiles output). */
     filePaths: string[];
-    /** Raw tokens file the user pointed at. Empty when the import does not generate tokens (components only). */
+    /** Raw tokens file the user pointed at (always set: v2 asks for one). */
     rawTokensPath: string;
+    /** From the token reuse step. 'reuse' skips token generation entirely. */
+    tokenStrategy: TokenStrategy;
     /** Null when the user skipped credentials: no existing-entities fetch happens. */
     credentials: {
         spaceId: string;

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

@@ -17,6 +17,5 @@ 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,13 +17,6 @@ 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/DoneStep.d.ts

@@ -1,5 +1,4 @@
 import React from 'react';
-import type { Produced } from '../support/produced.js';
 type EntityResult = {
     created: number;
     updated: number;
@@ -17,10 +16,6 @@ type DoneStepProps = {
     spaceId: string;
     environmentId: string;
     host?: string;
-    /** What the import produced, so only the links to those things are offered. */
-    produced: Produced;
-    /** The user skipped the credentials, so nothing could be pushed: the files were only saved. */
-    credentialsSkipped?: boolean;
     runTeaser?: string;
     failures?: Array<{
         entityType: string;
@@ -29,5 +24,5 @@ type DoneStepProps = {
     }>;
     onExit: () => void;
 };
-export declare function DoneStep({ componentTypes, designTokens, summary, spaceId, environmentId, host, produced, credentialsSkipped, failures, onExit, }: DoneStepProps): React.ReactElement;
+export declare function DoneStep({ componentTypes, designTokens, summary, spaceId, environmentId, host, failures, onExit, }: DoneStepProps): React.ReactElement;
 export {};

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

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

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-845e7310.0",
+  "version": "2.37.1-dev-build-923f560a.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-845e7310.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-845e7310.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-923f560a.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-923f560a.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/dist/src/tui/import/shared/overview-box/overview-box.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-export interface OverviewStep {
-    description: string;
-    /** Whether the step uses the user's local AI agent. */
-    ai: boolean;
-}
-/** The framed list of the steps an import goes through, with the AI disclosure under it. Shown by the intro screens. */
-export declare function OverviewBox({ steps }: {
-    steps: readonly OverviewStep[];
-}): React.ReactElement;

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

@@ -1,17 +0,0 @@
-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

@@ -1,46 +0,0 @@
-import type { OverviewStep } from '../../shared/index.js';
-export type ImportTarget = 'both' | 'tokens' | 'components';
-export declare const IMPORT_TARGET_OPTIONS: ReadonlyArray<{
-    target: ImportTarget;
-    label: string;
-}>;
-export declare const TOKENS_ONLY_OVERVIEW: readonly OverviewStep[];
-export declare const TOKENS_ONLY_STEP_COUNT: number;
-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

@@ -1,8 +0,0 @@
-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/06-extraction/run-tokens-only.d.ts

@@ -1,31 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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/support/produced.d.ts

@@ -1,15 +0,0 @@
-import type { FlowState } from '../flow/types.js';
-/** What an import produced, so the screens after the work can describe what happened and not a fixed pair. */
-export interface Produced {
-    components: boolean;
-    tokens: boolean;
-}
-/** Components exist when extraction ran; tokens exist when the token stage left a catalog or a session behind. */
-export declare function producedOf(state: Pick<FlowState, 'extractSessionId' | 'tokensPath' | 'tokenSessionId'>): Produced;
-/**
- * How the saved file is described: the file is always named `components.json`, but when only tokens were generated it
- * holds just the tokens, and calling it a components file would mislead.
- */
-export declare function fileSummaryLabel({ components }: Produced): string;
-/** "component types and design tokens", "design tokens", or "component types": the things this run writes. */
-export declare function writtenThings({ components, tokens }: Produced): string;