@contentful/experience-design-system-cli 2.38.0 → 2.38.1-dev-build-6d903339.0

package/legacy/dist/src/import/tui/WizardApp.d.ts

@@ -1,67 +0,0 @@
-import React from 'react';
-import type { CDFDocument, CDFComponentEntry, DTCGTokenEntry } from '@contentful/experience-design-system-types';
-import { type AgentAuthStatus } from '@contentful/experience-design-system-generation';
-export declare function buildGenerateComponentsArgs(opts: {
-    sessionId: string;
-    tokensPath?: string;
-    agent: string;
-    model?: string;
-    bedrock?: boolean;
-    noCache?: boolean;
-    generatePromptPath?: string;
-    promptOverrides?: string[];
-    existingEntitiesPath?: string;
-    restoreCache?: boolean;
-    cachedComponents?: string[];
-}): string[];
-export declare function buildGenerateTokensArgs(opts: {
-    rawTokensPath: string;
-    agent: string;
-    model?: string;
-    bedrock?: boolean;
-    noCache?: boolean;
-    promptOverrides?: string[];
-}): string[];
-export declare function buildMapTokensArgs(opts: {
-    sessionId: string;
-    agent: string;
-    model?: string;
-    noCache?: boolean;
-    skipAgent?: boolean;
-    promptOverrides?: string[];
-    existingEntitiesPath?: string;
-}): string[];
-export declare function shouldRunMapTokens(opts: {
-    mappablePropCount: number;
-    rawTokenCount: number;
-}): boolean;
-export declare function buildSavedCDF(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>, tokens: DTCGTokenEntry[], opts?: {
-    deleteAll?: boolean;
-}): CDFDocument;
-export declare function formatAcceptanceSummary(opts: {
-    accepted: number;
-    autoRejected: number;
-}): string;
-export declare function parsePrintTokensCount(stdout: string): number;
-export type WizardAppProps = {
-    initialSpaceId?: string;
-    initialEnvironmentId?: string;
-    initialCmaToken?: string;
-    initialHost?: string;
-    initialAgent?: string;
-    initialModel?: string;
-    bedrock?: boolean;
-    initialProjectPath?: string;
-    host?: string;
-    promptOverrides?: string[];
-    noCache?: boolean;
-    livePreview?: boolean;
-    generatePromptPath?: string;
-    skipMapTokens?: boolean;
-    initialRawTokensPath?: string;
-    initialAgentAuth?: Promise<AgentAuthStatus>;
-};
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, initialAgentAuth, }?: WizardAppProps): React.ReactElement;

package/legacy/dist/src/import/tui/run-selection-agent.d.ts

@@ -1,9 +0,0 @@
-import { type AgentName } from '@contentful/experience-design-system-generation';
-export declare function runSelectionAgent(options: {
-    sessionId: string;
-    agent: AgentName;
-    model?: string;
-    promptText?: string;
-    promptPath?: string;
-    noCache?: boolean;
-}): Promise<void>;

package/legacy/dist/src/import/tui/runScopeGate.d.ts

@@ -1,12 +0,0 @@
-export declare function runScopeGate(opts: {
-    sessionId: string;
-    decisions: {
-        accepted: string[];
-        rejected: string[];
-    };
-    onAdvanceToGenerate: (info: {
-        sessionId: string;
-        acceptedCount: number;
-    }) => Promise<void> | void;
-    onAdvanceToPushFlow: (acceptedCount: number) => Promise<void> | void;
-}): Promise<void>;

package/legacy/dist/src/import/tui/spawn-generate.d.ts

@@ -1,33 +0,0 @@
-/**
- * Extracted spawn helper for the `generate components` subprocess.
- *
- * Why this exists: the wizard now kicks off generation from TWO call sites —
- * the post-credentials path (`runGenerate`) AND a pre-fetch from scope-gate
- * confirm (Change 2 in the prefetch spec). Both need the same spawn-and-stream
- * behavior but the await-on-exit happens at different times. Keeping `runGenerate`
- * as a thin wrapper around this helper lets the pre-fetch path stash the
- * `donePromise` in a ref and resolve it later.
- *
- * Subprocess hygiene: we listen for 'close' (not 'exit') when surfacing the
- * final result so the child's stdio + any inherited file handles (e.g. the
- * pipeline SQLite WAL/SHM) have been fully released by the OS before the
- * wizard re-enters that path. This applies the same lesson as
- * fix/auto-filter-db-lock.
- */
-import { type ChildProcess } from 'node:child_process';
-export type SpawnGenerateResult = {
-    exitCode: number;
-    signal: NodeJS.Signals | null;
-    stdout: string;
-    stderr: string;
-};
-export type SpawnGenerateOpts = {
-    command: string;
-    args: string[];
-    onStderr?: (chunk: string) => void;
-    onStdout?: (chunk: string) => void;
-};
-export declare function spawnGenerateChild(opts: SpawnGenerateOpts): {
-    child: ChildProcess;
-    donePromise: Promise<SpawnGenerateResult>;
-};

package/legacy/dist/src/import/tui/steps/CredentialsStep.d.ts

@@ -1,43 +0,0 @@
-import React from 'react';
-type CredentialsStepProps = {
-    summary?: string;
-    error?: string;
-    initialSpaceId?: string;
-    initialEnvironmentId?: string;
-    initialCmaToken?: string;
-    initialHost?: string;
-    /**
-     * When true, the credentials screen stays mounted but locks input and shows
-     * an inline "Validating credentials..." status. Replaces the previous
-     * dedicated `validating-credentials` render screen so the operator sees a
-     * continuous credentials surface instead of a transient loading screen
-     * (Change 1 of the wizard prefetch refactor).
-     */
-    validating?: boolean;
-    /** Background validation of unchanged prefilled credentials; input remains editable. */
-    backgroundValidating?: boolean;
-    /** Inline status describing in-flight background generation prefetch. */
-    generatePrefetchStatus?: 'idle' | 'running' | 'complete' | 'failed';
-    /** Error message from a failed generation prefetch (rendered as a banner). */
-    generatePrefetchError?: string | null;
-    /** Called when the user submits with any field changed from its initial value */
-    onConfirm: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
-    onValuesChange?: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
-    /** Called when the user submits without changing any field (use existing creds as-is) */
-    onContinue?: (spaceId: string, environmentId: string, cmaToken: string, host: string) => void;
-    onQuit: () => void;
-    /**
-     * Optional retry callback wired up when a background generation prefetch
-     * failed mid-credentials-entry. The operator presses R to re-trigger.
-     */
-    onRetryPrefetch?: () => void;
-    /**
-     * Skip-credentials escape hatch. When pressed (via `s` keybind, gated
-     * against text-entry mode), the wizard advances without validating
-     * credentials and disables push downstream. See dsi-tui-skip-credentials
-     * spec.
-     */
-    onSkip?: () => void;
-};
-export declare function CredentialsStep({ summary, error: externalError, initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, validating, backgroundValidating, generatePrefetchStatus, generatePrefetchError, onConfirm, onValuesChange, onContinue, onQuit, onRetryPrefetch, onSkip, }: CredentialsStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/steps/GateStep.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-type GateStepProps = {
-    successMessage: string;
-    summary?: string;
-    context?: string;
-    continueLabel?: string;
-    skipLabel?: string;
-    onContinue: () => void;
-    onSkip?: () => void;
-    onQuit: () => void;
-    showSkip?: boolean;
-    intent?: 'success' | 'error';
-};
-export declare function GateStep({ successMessage, summary, context, continueLabel, skipLabel, onContinue, onSkip, onQuit, showSkip, intent, }: GateStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/steps/PathValidationStep.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-type PathValidationStepProps = {
-    projectPath: string;
-    onConfirm: (projectPath: string) => void;
-    onSkipComponents: () => void;
-    onChangePath: () => void;
-    onQuit: () => void;
-};
-export declare function PathValidationStep({ projectPath, onConfirm, onSkipComponents, onChangePath, onQuit, }: PathValidationStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/steps/PreviewValidationErrorStep.d.ts

@@ -1,11 +0,0 @@
-import React from 'react';
-import type { PreviewValidationError } from '../../../apply/api-client.js';
-type PreviewValidationErrorStepProps = {
-    errors: PreviewValidationError[];
-    missingNames: string[];
-    onEdit: () => void;
-    onSkip: () => void;
-    onQuit: () => void;
-};
-export declare function PreviewValidationErrorStep({ errors, missingNames, onEdit, onSkip, onQuit, }: PreviewValidationErrorStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/steps/RunningStep.d.ts

@@ -1,32 +0,0 @@
-import React from 'react';
-type Progress = {
-    done: number;
-    total: number;
-};
-type RunningStepProps = {
-    stepNumber: number;
-    totalSteps: number;
-    title: string;
-    description: string;
-    detail?: string;
-    detailComplete?: boolean;
-    /** Progress for the detail row (displays as progress bar + ratio). */
-    detailProgress?: Progress;
-    /** Optional second progress line (own spinner) — e.g. composition resolution
-     *  running after the file scan on the extracting screen. */
-    secondaryDetail?: string;
-    secondaryComplete?: boolean;
-    /** Progress for the secondary detail row (displays as progress bar + ratio). */
-    secondaryProgress?: Progress;
-    /** Optional third progress line for another concurrent stage. */
-    tertiaryDetail?: string;
-    tertiaryComplete?: boolean;
-    /** Optional fourth progress line for another concurrent stage. */
-    quaternaryDetail?: string;
-    quaternaryComplete?: boolean;
-    /** Optional fifth progress line for another concurrent stage. */
-    quinaryDetail?: string;
-    quinaryComplete?: boolean;
-};
-export declare function RunningStep({ stepNumber, totalSteps, title, description, detail, detailComplete, detailProgress, secondaryDetail, secondaryComplete, secondaryProgress, tertiaryDetail, tertiaryComplete, quaternaryDetail, quaternaryComplete, quinaryDetail, quinaryComplete, }: RunningStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/steps/ScopeGateStep.d.ts

@@ -1,48 +0,0 @@
-import React from 'react';
-export type ScopeComponent = {
-    name: string;
-    componentId: string;
-    aiDecision?: 'accepted' | 'rejected' | 'failed' | null;
-    aiReason?: string | null;
-    needsReview?: boolean;
-    slots?: Array<{
-        name: string;
-        allowedComponents: string[];
-    }>;
-};
-export type ScopeGateStepProps = {
-    components: ScopeComponent[];
-    onConfirm: (decisions: {
-        accepted: string[];
-        rejected: string[];
-    }) => void;
-    onQuit: () => void;
-    aiFilterStatus?: 'idle' | 'running' | 'complete' | 'cancelled' | 'failed';
-    aiFilterProgress?: {
-        done: number;
-        total: number;
-    } | null;
-    aiFilterError?: string | null;
-    onCancelAutoFilter?: () => void;
-};
-export declare function ScopeGateStep(props: ScopeGateStepProps): React.ReactElement;
-export declare function sideColumnLabelStyle(input: {
-    isCycle: boolean;
-    isSelected: boolean;
-    focused: boolean;
-}): {
-    nameColor: string | undefined;
-    nameBold: boolean;
-    nameInverse: boolean;
-    nameUnderline: boolean;
-    suffixColor: string | undefined;
-    suffixDim: boolean;
-    suffixInverse: boolean;
-    suffixUnderline: boolean;
-};
-export declare function computeColumnWindow(total: number, cursor: number, visibleCount: number): {
-    start: number;
-    end: number;
-    above: number;
-    below: number;
-};

package/legacy/dist/src/import/tui/steps/TokenInputStep.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-type TokenInputStepProps = {
-    onConfirm: (rawTokensPath: string) => void;
-    onSkip: () => void;
-    onQuit: () => void;
-};
-export declare function TokenInputStep({ onConfirm, onSkip, onQuit }: TokenInputStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/steps/WelcomeStep.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-type WelcomeStepProps = {
-    onContinue: (projectPath: string) => void;
-    onQuit: () => void;
-};
-export declare function WelcomeStep({ onContinue, onQuit }: WelcomeStepProps): React.ReactElement;
-export {};

package/legacy/dist/src/import/tui/wizard-422-helpers.d.ts

@@ -1,48 +0,0 @@
-import { ApiError, type PreviewValidationError } from '../../apply/api-client.js';
-import { patchReviewStateWithValidationErrors, rejectComponentsByName } from '../../analyze/select/command.js';
-export type Preview422Outcome = {
-    kind: 'validation-error';
-    errors: PreviewValidationError[];
-    missingNames: string[];
-} | {
-    kind: 'unparseable';
-    message: string;
-} | {
-    kind: 'not-422';
-};
-/**
- * Decide what to do with an `ApiError` raised by `previewImport()`.
- * Returns `not-422` if the caller should fall through to its other branches
- * (404 / 401 / 403 / generic), `unparseable` if the body cannot be parsed
- * into structured component-level errors (caller should route to the generic
- * error step), or `validation-error` with the patched-state side effects
- * already applied.
- *
- * Pure decision logic + a single delegated side effect to
- * `patchReviewStateWithValidationErrors`. Extracted from `WizardApp.runPreview`
- * so the routing is unit-testable without driving the full TUI.
- */
-export declare function handlePreview422(err: ApiError, extractSessionId: string | null, patchFn?: typeof patchReviewStateWithValidationErrors): Promise<Preview422Outcome>;
-/**
- * The WizardState patch the wizard should spread into any update that
- * transitions OUT of the preview-validation-error step (e.g. into
- * preview-gate after a successful retry). Without this, the validation-error
- * arrays linger in state and any future code path that reads them sees stale
- * data from a prior failed attempt.
- */
-export declare function clearedValidationErrorState(): {
-    previewValidationErrors: PreviewValidationError[];
-    previewValidationMissingNames: string[];
-};
-/**
- * Run the "skip and retry" side effect: dedup the offending component
- * names from a list of errors and call `rejectComponentsByName`. Returns
- * the deduped names so the caller can log them or include them in test
- * assertions. No-op when sessionId is null or errors are empty.
- *
- * The DB update inside `rejectComponentsByName` is what makes the next
- * preview see a CDF document with the offenders excluded — see SP-3 retro
- * Bug 1: writing to the JSON state file alone is not enough because
- * `loadCDFComponents` reads from the pipeline DB.
- */
-export declare function applySkipValidationErrors(sessionId: string | null, errors: PreviewValidationError[], rejectFn?: typeof rejectComponentsByName): Promise<string[]>;

package/legacy/dist/src/import/tui/wizard-generate-progress.d.ts

@@ -1,21 +0,0 @@
-/**
- * Pure parser for the generate-step stderr stream.
- *
- * Two line shapes can carry progress info:
- *
- * 1. `progress=generate:<done>/<total>:<name>` — emitted at terminal completion
- *    of each component in `runAllComponents`. `done` is the count of completed
- *    components and is monotonically non-decreasing.
- * 2. `[<index+1>/<total>] <name>` — legacy line emitted at the START of each
- *    component (and again on retry). With concurrency > 1, the index reflects
- *    the worker's starting position, not completions, so it MUST NOT drive
- *    `done` — only `current` (the name shown to the user).
- *
- * Given a chunk and the previous state, returns the updated state.
- */
-export type GenerateProgressState = {
-    done: number;
-    total: number;
-    current: string;
-} | null;
-export declare function parseGenerateStderrChunk(chunk: string, prev: GenerateProgressState): GenerateProgressState;