@contentful/experience-design-system-cli 2.37.1-dev-build-dbc9f30e.0 → 2.37.1-dev-build-8b126ca1.0

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { FlowController } from './controller.js';
+import type { FlowState } from './types.js';
+interface FlowScreenProps {
+    state: FlowState;
+    controller: FlowController;
+    livePreview?: boolean;
+    generatePromptPath?: string;
+    /** Leaves the import with the exit code the wizard would have exited with. */
+    onExit: (exitCode: number) => void;
+}
+/** How many steps the import has, as the wizard counted them. */
+export declare function totalStepsFor(state: Pick<FlowState, 'tokensPath' | 'rawTokensPath' | 'mapTokensEligible'>): number;
+/** Whether the preview gate offers "[e] Edit definitions": only when the document has components to edit. */
+export declare function canEditFromPreview(cdf: FlowState['cdf']): boolean;
+export declare function FlowScreen({ state, controller, livePreview, generatePromptPath, onExit, }: FlowScreenProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,71 @@
+import type { CDFDocument, ServerPreviewResponse } from '@contentful/experience-design-system-types';
+import type { PreviewValidationError } from '@contentful/experience-design-system-backend-pipeline';
+import type { PushProgress } from '../support/push-progress.js';
+/**
+ * The steps of the import after the review, as the wizard had them. The ones that came before (credentials, extraction,
+ * the scope gate, generation) are v2 stages of their own now.
+ */
+type FlowStep = 'final-review' | 'previewing' | 'preview-gate' | 'pushing' | 'path-prompt' | 'printing' | 'print-gate' | 'done' | 'error' | 'preview-validation-error';
+export type PushResult = {
+    componentTypes: {
+        created: number;
+        updated: number;
+        removed: number;
+        failed: number;
+    };
+    designTokens: {
+        created: number;
+        updated: number;
+        removed: number;
+        failed: number;
+    };
+    summary?: {
+        total: number;
+        succeeded: number;
+        failed: number;
+    };
+    failures?: Array<{
+        entityType: string;
+        entityId: string;
+        message: string;
+    }>;
+};
+/** Everything the flow keeps between steps. The same fields the wizard kept, minus those only the early stages used. */
+export type FlowState = {
+    step: FlowStep;
+    agent: string;
+    projectPath: string;
+    outDir: string;
+    rawTokensPath: string;
+    tokensPath: string;
+    tokenSessionId: string | null;
+    tokenCount: number;
+    extractSessionId: string | null;
+    generateSessionId: string | null;
+    generatedCount: number;
+    generatedAcceptedCount: number;
+    componentsPath: string;
+    spaceId: string;
+    environmentId: string;
+    cmaToken: string;
+    host: string;
+    serverPreview: ServerPreviewResponse | null;
+    cdf: CDFDocument | null;
+    pushProgress: PushProgress;
+    pushResult: PushResult;
+    errorStep: string;
+    errorMessage: string;
+    errorAllowCredentialRetry: boolean;
+    errorAllowBreakingChangeAcknowledgment: boolean;
+    previewValidationErrors: PreviewValidationError[];
+    previewValidationMissingNames: string[];
+    mapTokensEligible: boolean | null;
+    credentialsSkipped: boolean;
+    lastRunId: string | null;
+    finalizeErrorBanner: string | null;
+    finalReviewPassed: boolean;
+};
+/** A change to the state. The steps of the flow return these instead of changing the state themselves. */
+export type FlowPatch = Partial<FlowState>;
+export declare const EMPTY_PUSH_RESULT: PushResult;
+export {};

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

@@ -0,0 +1,9 @@
+import { type FlowController, type FlowDeps, type FlowStart } from './controller.js';
+/**
+ * The flow for a start, once. `start` is undefined until the generation stage has finished, so the hook can be called
+ * unconditionally; the step log is started with the controller, as the wizard started it with its first render.
+ */
+export declare function useFlow(start: FlowStart | undefined, deps?: () => FlowDeps): {
+    controller: FlowController;
+    state: ReturnType<FlowController['getState']>;
+} | undefined;

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

@@ -0,0 +1,28 @@
+import React from 'react';
+type EntityResult = {
+    created: number;
+    updated: number;
+    removed: number;
+    failed: number;
+};
+type DoneStepProps = {
+    componentTypes: EntityResult;
+    designTokens: EntityResult;
+    summary?: {
+        total: number;
+        succeeded: number;
+        failed: number;
+    };
+    spaceId: string;
+    environmentId: string;
+    host?: string;
+    runTeaser?: string;
+    failures?: Array<{
+        entityType: string;
+        entityId: string;
+        message: string;
+    }>;
+    onExit: () => void;
+};
+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/PathPrompt.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export type PathPromptProps = {
+    defaultPath: string;
+    onSubmit: (path: string) => void;
+    onCancel: () => void;
+    label?: string;
+};
+export declare function PathPrompt({ defaultPath, onSubmit, onCancel, label, }: PathPromptProps): React.ReactElement;

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

@@ -0,0 +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({ stepNumber, totalSteps, progress }: PushingStepProps): React.ReactElement;
+export {};

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
+export interface PreviewDiffLine {
+    key: string;
+    color: string;
+    text: string;
+}
+export declare function buildPreviewSummaryLines(preview: ServerPreviewResponse): PreviewDiffLine[];
+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, stepNumber, totalSteps, onConfirm, onEdit, onQuit, }: WizardPreviewStepProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/10-flow/support/contentful-urls.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared Contentful webapp URL builders.
+ *
+ * This module centralizes the formatter so the wizard and `apply` emit
+ * the same URL shape.
+ */
+type PostPushView = 'components' | 'design_tokens';
+export interface BuildPostPushUrlInput {
+    host: string;
+    spaceId: string;
+    environmentId: string;
+    view?: PostPushView;
+}
+export declare function buildPostPushUrl({ host, spaceId, environmentId, view }: BuildPostPushUrlInput): string;
+export {};

package/dist/src/tui/import/steps/10-flow/support/path-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Expands a leading `~` to the user's home directory.
+ * Exported separately so it can be unit-tested and reused.
+ */
+export declare function expandTilde(input: string): string;
+/**
+ * Normalizes a user-entered path to an absolute path, handling all common
+ * terminal path styles:
+ *   - surrounding quotes ("~/path" or '~/path')  → stripped
+ *   - tilde prefix (~/projects/mylib)             → expanded to $HOME
+ *   - relative paths (../mylib, ./src, mylib)     → resolved against CWD
+ *   - absolute paths (/Users/ryun/projects/mylib) → passed through
+ *   - trailing slashes, repeated slashes          → normalized by path.resolve
+ */
+export declare function normalizePath(input: string): string;

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

@@ -0,0 +1,5 @@
+type PreviewConfirmationKey = {
+    return: boolean;
+};
+export declare function usePreviewConfirmationInput(breakingWithImpact: boolean, onConfirm: (acknowledge: boolean) => void): (input: string, key: PreviewConfirmationKey) => boolean;
+export {};

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

@@ -0,0 +1,10 @@
+import type { ChangeClassification, ComponentTypeSummary, PropertySummary } from '@contentful/experience-design-system-types';
+export interface PropertyDiffLine {
+    key: string;
+    color: 'green' | 'red' | 'yellow';
+    text: string;
+}
+export declare function computeComponentDiffLines(current: ComponentTypeSummary, proposed: Record<string, unknown>, changeClassification?: ChangeClassification): PropertyDiffLine[];
+export declare function diffProperty(name: string, old: PropertySummary, newDef: Record<string, unknown>): PropertyDiffLine[];
+export declare function formatOldProp(prop: PropertySummary): string;
+export declare function formatPropDef(def: Record<string, unknown>): string;

package/dist/src/tui/import/steps/10-flow/support/push-progress.d.ts

@@ -0,0 +1,9 @@
+export type PushProgress = {
+    kind: 'queued';
+    operationId: string;
+} | {
+    kind: 'progress';
+    processed: number;
+    total: number;
+    current: string | null;
+} | null;

package/dist/src/tui/import/steps/10-flow/support/run-print-files-helpers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Computes the wizard state patch applied after `runPrintFiles` successfully
+ * writes components.json. Default behavior transitions to the print-gate
+ * confirm screen. When `skipGate: true` is passed (used by the "save AND push"
+ * path), the transition is suppressed so the caller can chain into
+ * `runPreview` without an intermediate gate render.
+ *
+ * When `outDir` is provided (Task 4 — operator chose a custom save path via
+ * the inline path-prompt), it is folded into the patch so the wizard's
+ * `state.outDir` reflects the chosen path. Subsequent reads (e.g. the
+ * appendRun call, the print-gate's summary) pick it up automatically.
+ */
+export type NextStateAfterPrintInput = {
+    skipGate?: boolean;
+    componentsPath: string;
+    outDir?: string;
+};
+export type NextStateAfterPrintOutput = {
+    componentsPath: string;
+    outDir?: string;
+} | {
+    step: 'print-gate';
+    componentsPath: string;
+    outDir?: string;
+};
+export declare function nextStateAfterPrint(opts: NextStateAfterPrintInput): NextStateAfterPrintOutput;

package/dist/src/tui/import/steps/10-flow/support/run-teaser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Task 8 — one-line teaser appended at the end of every successful run.
+ * Format pinned in dsi-tui-local-save-tooling-spec.md Part 6.
+ */
+export declare function buildRunTeaserLine(runId: string | null | undefined): string;

package/dist/src/tui/import/steps/10-flow/support/use-blinking-cursor.d.ts

@@ -0,0 +1 @@
+export declare function useBlinkingCursor(): boolean;

package/dist/src/tui/import/steps/10-flow/support/use-timed-spinner.d.ts

@@ -0,0 +1,4 @@
+export declare function useTimedSpinner(): {
+    spinner: React.ReactElement;
+    elapsed: string;
+};

package/dist/src/tui/import/steps/10-flow/support/wizard-state-transitions.d.ts

@@ -0,0 +1,17 @@
+export declare function shouldBypassPreview(state: {
+    credentialsSkipped: boolean;
+}): boolean;
+export declare function buildSkippedPreviewTransition(): {
+    step: 'done';
+    serverPreview: null;
+};
+export type CycleGateAction = 'block' | 'proceed';
+export declare function resolveCycleGateAction(opts: {
+    hasCycles: boolean;
+}): CycleGateAction;
+export declare function shouldRefusePush(state: {
+    credentialsSkipped: boolean;
+}): boolean;
+export declare function buildSkippedPushTransition(): {
+    step: 'print-gate';
+};

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

@@ -0,0 +1,13 @@
+export declare const PALETTE: {
+    readonly link: "#58A6FF";
+    readonly info: "#1773EB";
+    readonly success: "#00C459";
+    readonly error: "#E44F20";
+    readonly warning: "#FFDA00";
+    readonly muted: "#8B8D91";
+    readonly border: "#C4D1DE";
+    readonly inverse: "#FFFFFF";
+};
+export declare const INK_UI_THEME: {
+    components: Record<string, import("@inkjs/ui").ComponentTheme>;
+};

package/dist/src/tui/import/steps/preview-validation-error/logic.d.ts

@@ -0,0 +1,12 @@
+export interface PreviewValidationError {
+    componentName: string;
+    path: string;
+    message: string;
+}
+export declare function failedComponentNames(errors: readonly PreviewValidationError[]): string[];
+export declare function matchedComponentNames(errors: readonly PreviewValidationError[], missingNames: readonly string[]): string[];
+export declare function formatErrorLine(error: PreviewValidationError): string;
+export declare function formatErrorLines(errors: readonly PreviewValidationError[]): string;
+export declare function missingNote(missingNames: readonly string[]): string;
+export declare function contextText(errors: readonly PreviewValidationError[], missingNames: readonly string[]): string;
+export declare function skipLabel(matchedNames: readonly string[]): string;

package/dist/src/tui/import/steps/preview-validation-error/screen.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { type PreviewValidationError } from './logic.js';
+interface PreviewValidationErrorScreenProps {
+    errors: readonly PreviewValidationError[];
+    missingNames: readonly string[];
+    onEdit: () => void;
+    onSkip: () => void;
+    onQuit: () => void;
+}
+export declare function PreviewValidationErrorScreen({ errors, missingNames, onEdit, onSkip, onQuit, }: PreviewValidationErrorScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/user-agent.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The `X-Contentful-User-Agent` for the CLI's requests to the Contentful API, so writes are attributed to the CLI
+ * (CEP-0056). Legacy sent the same string, built from its own package version.
+ */
+export declare function cliUserAgent(): string;

package/legacy/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-dbc9f30e.0",
+  "version": "2.37.1-dev-build-8b126ca1.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,9 +45,9 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-dbc9f30e.0",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-dbc9f30e.0",
-    "@contentful/experience-design-system-generation": "2.37.1-dev-build-dbc9f30e.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-8b126ca1.0",
+    "@contentful/experience-design-system-generation": "2.37.1-dev-build-8b126ca1.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-8b126ca1.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/dist/src/tui/import/spawn-v1-import.d.ts

@@ -1,36 +0,0 @@
-import { type ImportOptions } from '../../commands/import-options.js';
-import { type ImportHandoff } from '@contentful/experience-design-system-types/handoff';
-interface StepResult {
-    step: string;
-    status: 'complete' | 'failed' | 'skipped';
-    durationMs?: number;
-    reason?: string;
-    detail?: Record<string, unknown>;
-    error?: string;
-}
-interface PipelineResult {
-    session: string;
-    project: string;
-    steps: StepResult[];
-    cycleError?: {
-        report: string[];
-    };
-}
-export interface SpawnV1ImportOptions extends Partial<ImportOptions> {
-    projectPath?: string;
-    tokens?: string;
-    filePaths?: string[];
-    /** What the CLI already settled and did; the legacy wizard starts from it. */
-    handoff?: ImportHandoff;
-    onProgress?: (line: string) => void;
-}
-export interface SpawnV1ImportResult {
-    exitCode: number;
-    result?: PipelineResult;
-    stdout: string;
-    stderr: string;
-}
-export declare function buildArgs(options: SpawnV1ImportOptions): string[];
-export declare function buildEnv(options: SpawnV1ImportOptions, base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
-export declare function spawnV1Import(options?: SpawnV1ImportOptions): Promise<SpawnV1ImportResult>;
-export {};

package/dist/src/tui/import/terminal-input.d.ts

@@ -1,2 +0,0 @@
-export declare function stopReadingTerminal(): Promise<void>;
-export declare function startReadingTerminal(): void;