@contentful/experience-design-system-cli 2.37.1-dev-build-12711902.0 → 2.37.1-dev-build-aa3ffe6f.0

package/legacy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-12711902.0",
+  "version": "2.37.1-dev-build-aa3ffe6f.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-12711902.0",
+  "version": "2.37.1-dev-build-aa3ffe6f.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-12711902.0",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-12711902.0",
-    "@contentful/experience-design-system-generation": "2.37.1-dev-build-12711902.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-aa3ffe6f.0",
+    "@contentful/experience-design-system-generation": "2.37.1-dev-build-aa3ffe6f.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-aa3ffe6f.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;

package/legacy/dist/src/import/agent-model-resolve.d.ts

@@ -1,27 +0,0 @@
-/**
- * Resolution chain for the combined `--agent` override on `experiences import`.
- *
- * The wizard path previously hard-defaulted `--agent` to `'claude'` at the
- * commander layer, which (a) shadowed the stored `credentials.json` value when
- * the user passed no flag, and (b) made it impossible to distinguish "user
- * explicitly passed --agent claude" from "user passed nothing". The combined
- * flag accepts either `agent:model` or `agent model`.
- *
- * These helpers produce the resolved values to feed into `WizardApp` /
- * the import wizard:
- *
- *   1. CLI flag wins when provided.
- *   2. Otherwise, the value persisted in `credentials.json` (written by
- *      `experiences setup`) is used.
- *   3. Otherwise, the built-in default (currently `'claude'`) is used for
- *      the agent. Model has no default — agents pick a small/fast model
- *      themselves when no model is included in `--agent`.
- */
-/** Built-in fallback agent when neither a flag nor a stored preference is set. */
-export declare const DEFAULT_AGENT = "claude";
-export declare function parseAgentModel(value: string | undefined): {
-    agent?: string;
-    model?: string;
-};
-export declare function resolveAgent(flagValue: string | undefined, storedValue: string | undefined): string;
-export declare function resolveModel(flagValue: string | undefined, storedValue: string | undefined): string | undefined;

package/legacy/dist/src/import/command.d.ts

@@ -1,2 +0,0 @@
-import type { Command } from 'commander';
-export declare function registerImportCommand(program: Command): void;

package/legacy/dist/src/import/composition-options.d.ts

@@ -1,7 +0,0 @@
-export type CompositionOptionInput = {
-    prompt?: string[];
-};
-export type CompositionForwardingOptions = {
-    promptOverrides?: string[];
-};
-export declare function buildCompositionForwardingOptions(options: CompositionOptionInput): CompositionForwardingOptions;

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

@@ -1,24 +0,0 @@
-import React from 'react';
-import type { CDFDocument, CDFComponentEntry, DTCGTokenEntry } from '@contentful/experience-design-system-types';
-export declare function buildSavedCDF(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>, tokens: DTCGTokenEntry[], opts?: {
-    deleteAll?: boolean;
-}): CDFDocument;
-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;
-    livePreview?: boolean;
-    generatePromptPath?: string;
-    initialRawTokensPath?: string;
-};
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, livePreview, generatePromptPath, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;

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

@@ -1,5 +0,0 @@
-export interface AutocompleteResult {
-    completion: string;
-    candidates: string[];
-}
-export declare function computeAutocomplete(query: string, names: string[]): AutocompleteResult;

package/legacy/dist/src/import/tui/components/CompactControlBar.d.ts

@@ -1,4 +0,0 @@
-export declare function CompactControlBar({ hasGroupRoots, searchActive }: {
-    hasGroupRoots: boolean;
-    searchActive: boolean;
-}): import("react/jsx-runtime").JSX.Element;

package/legacy/dist/src/import/tui/components/LegendEntry.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare function legendEntry(keyBracket: string, label: string, active?: boolean): React.ReactElement;

package/legacy/dist/src/import/tui/components/SearchMatchSummary.d.ts

@@ -1,11 +0,0 @@
-import React from 'react';
-export type SearchMatchSummaryProps = {
-    open: boolean;
-    query: string;
-    matches: number;
-    total: number;
-    autocompleteCandidates: string[];
-    hidden?: boolean;
-    marginTop?: number;
-};
-export declare function SearchMatchSummary({ open, query, matches, total, autocompleteCandidates, hidden, marginTop, }: SearchMatchSummaryProps): React.ReactElement | null;

package/legacy/dist/src/import/tui/group-collapse.d.ts

@@ -1,2 +0,0 @@
-import type { Closure } from '../../analyze/composite-closure.js';
-export declare function resolveGroupRoot(key: string, closures: Map<string, Closure>, cycleSet: Set<string>): string | undefined;

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

@@ -1,36 +0,0 @@
-import { type ImportHandoff } from '@contentful/experience-design-system-types/handoff';
-/** The wizard state the early stages produce. Every field is one the stage used to write. */
-export interface HandoffState {
-    credentialsSkipped: boolean;
-    tokensPath?: string;
-    tokenSessionId?: string | null;
-    tokenCount?: number;
-    tokenGenerationStatus?: 'complete';
-    outDir?: string;
-    extractSessionId?: string;
-    compositionPhase?: 'done' | 'cache-hit';
-    selectionAgentStatus?: 'complete';
-    existingEntitiesStatus?: 'idle' | 'complete' | 'failed';
-    existingEntitiesPath?: string | null;
-    acceptedCount?: number;
-    autoRejectedCount?: number;
-    generateSessionId?: string;
-    generatedCount?: number;
-    mapTokensEligible?: boolean;
-    mapTokensStatus?: 'complete';
-}
-/** Where the wizard goes first: the review screen with the generated definitions, or straight to saving and pushing. */
-export type StartRoute = 'review' | 'push';
-export declare function routeFromHandoff(handoff: ImportHandoff): StartRoute | null;
-export declare function stateFromHandoff(handoff: ImportHandoff): HandoffState;
-export type StartFromHandoff = {
-    ok: true;
-    handoff: ImportHandoff;
-    state: HandoffState;
-    route: StartRoute | null;
-} | {
-    ok: false;
-    error: string;
-};
-/** Reads the handoff the CLI passed. A missing or broken one is an error to show, never a guess at a start. */
-export declare function readHandoff(env?: NodeJS.ProcessEnv): StartFromHandoff;

package/legacy/dist/src/import/tui/hooks/sidebar-search-state.d.ts

@@ -1,17 +0,0 @@
-import type { FilterCategory } from '../step-filters.js';
-export declare function useSidebarSearchState(): {
-    searchOpen: boolean;
-    setSearchOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    searchQuery: string;
-    setSearchQuery: import("react").Dispatch<import("react").SetStateAction<string>>;
-    autocompleteCandidates: string[];
-    setAutocompleteCandidates: import("react").Dispatch<import("react").SetStateAction<string[]>>;
-    jumpFilterTarget: string | null;
-    setJumpFilterTarget: import("react").Dispatch<import("react").SetStateAction<string | null>>;
-    columnOneView: "flat" | "grouped";
-    setColumnOneView: import("react").Dispatch<import("react").SetStateAction<"flat" | "grouped">>;
-    activeFilters: Set<FilterCategory>;
-    setActiveFilters: import("react").Dispatch<import("react").SetStateAction<Set<FilterCategory>>>;
-    showHelp: boolean;
-    setShowHelp: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-};

package/legacy/dist/src/import/tui/hooks/useOverlayPanel.d.ts

@@ -1,13 +0,0 @@
-export interface UseOverlayPanelOptions {
-    toggleKey: string;
-    onClose?: () => void;
-}
-export interface UseOverlayPanelResult {
-    isOpen: boolean;
-    open: () => void;
-    close: () => void;
-    handleInput: (input: string, key: {
-        escape?: boolean;
-    }) => boolean;
-}
-export declare function useOverlayPanel(opts: UseOverlayPanelOptions): UseOverlayPanelResult;

package/legacy/dist/src/import/tui/lineage-layout.d.ts

@@ -1,68 +0,0 @@
-/** Maximum layout rows; the active terminal height determines the actual budget. */
-export declare const VISIBLE_COUNT = 200;
-/** Maximum supported panel window; normal terminals remain terminal-sized. */
-export declare const MAX_PANEL_ROWS = 200;
-/** Floors — both surfaces stay usable even on a small terminal. */
-export declare const SIDEBAR_MIN = 4;
-export declare const MIN_PANEL_ROWS = 4;
-/**
- * Fallback when `stdout.rows` is unavailable (piped output, tests). No TTY
- * means Ink is not interactively repainting, so there is no flicker risk — we
- * assume enough height for a terminal-sized sidebar so the non-interactive
- * render is complete and unclipped.
- */
-export declare const FALLBACK_ROWS = 40;
-/**
- * Vertical space consumed by everything ABOVE/BELOW the columns row. The panel
- * shares the columns row, so the fit constraint while open is simply
- * `FIXED_OVERHEAD + panelBoxHeight <= rows`.
- */
-export declare const FIXED_OVERHEAD: number;
-export declare const PANEL_BOX_CHROME = 6;
-/**
- * L2e — fixed vertical chrome around the sidebar in the BASE (no-panel) case,
- * counting EVERYTHING that is not a variable sidebar entry row: the wizard
- * header bar, the counter strip (with its blank separator), the cycle banner,
- * the nothing-selected /
- * AI-exclusion hint, the GroupedSidebar box borders + scroll indicator, the
- * focused-detail block, and the wrapping legend region. The value intentionally
- * leaves a small safety margin so resize-induced wrapping does not overflow.
- */
-export declare const BASE_CHROME_OVERHEAD = 18;
-export interface LineageLayoutInput {
-    /** Terminal height in rows (`stdout.rows`, or the fallback). */
-    rows: number;
-    /** Whether the lineage panel is currently open. */
-    panelOpen: boolean;
-    /** Number of lineage entries — caps the panel window so it never over-allocates. */
-    entryCount?: number;
-}
-export interface LineageLayout {
-    /** Rows the sidebar should render (`visibleCount`). Constant across open/closed. */
-    sidebarVisible: number;
-    /** Rows a sidebar replacement panel should window to (`maxRows`). */
-    panelMaxRows: number;
-}
-/**
- * The sidebar height is constant (the panel replaces it in the same slot, so
- * there is nothing to shrink). Both values are derived from the terminal so
- * resizing grows or shrinks the viewport without content-driven layout changes.
- */
-export declare function computeLineageLayout({ rows, panelOpen, entryCount }: LineageLayoutInput): LineageLayout;
-export interface SidebarBudget {
-    /** Rows the GroupedSidebar should render (`visibleCount`). */
-    sidebarVisibleCount: number;
-    /** Rows a sidebar replacement panel should window to (`maxRows`). */
-    panelMaxRows: number;
-}
-/**
- * L2e — autoscale the BASE frame to the terminal height. Even with the lineage
- * panel closed, the visible-row budget follows `stdout.rows` minus
- * `BASE_CHROME_OVERHEAD` so the whole frame stays within the terminal while
- * preserving the shared panel-open sizing behavior.
- *
- * Floor: `BASE_CHROME_OVERHEAD + SIDEBAR_MIN`. Below it `SIDEBAR_MIN`
- * (usability) intentionally wins over the fit — a terminal that small can't
- * host the chrome regardless.
- */
-export declare function computeSidebarBudget({ rows, panelOpen, entryCount }: LineageLayoutInput): SidebarBudget;

package/legacy/dist/src/import/tui/sidebar-help.d.ts

@@ -1,2 +0,0 @@
-import type { HelpSection } from '../../analyze/select/tui/components/HelpOverlay.js';
-export declare function createSidebarViewsHelpSection(includeBreaking: boolean): HelpSection;

package/legacy/dist/src/import/tui/sidebar-input.d.ts

@@ -1,13 +0,0 @@
-type SearchInputKey = {
-    tab: boolean;
-    backspace: boolean;
-};
-type SearchInputOptions = {
-    query: string;
-    names: string[];
-    setQuery: (value: string | ((current: string) => string)) => void;
-    setCandidates: (value: string[]) => void;
-};
-export declare function handleSidebarSearchInput(input: string, key: SearchInputKey, { query, names, setQuery, setCandidates }: SearchInputOptions): boolean;
-export declare function formatSearchMatchSummary(matches: number, total: number): string;
-export {};

package/legacy/dist/src/import/tui/sidebar-navigation.d.ts

@@ -1,18 +0,0 @@
-import type { ComponentGraphNode, Closure } from '../../analyze/composite-closure.js';
-import { type GroupedSidebarItem } from '../../analyze/select/tui/components/GroupedSidebar.js';
-export declare function collectExpandedGroupRoots(closures: Map<string, Closure>, cycleParticipants: Iterable<string>): Set<string>;
-export declare function computeSidebarViewToggle({ currentView, currentKey, currentScroll, visibleCount, items, cycleParticipants, expandedGroups, graph, showFlatTier, }: {
-    currentView: 'grouped' | 'flat';
-    currentKey: string | null | undefined;
-    currentScroll: number;
-    visibleCount: number;
-    items: GroupedSidebarItem[];
-    cycleParticipants: Set<string>;
-    expandedGroups: Set<string>;
-    graph: ComponentGraphNode[];
-    showFlatTier?: boolean;
-}): {
-    view: 'grouped' | 'flat';
-    cursor: number;
-    scroll: number;
-};

package/legacy/dist/src/import/tui/step-filters.d.ts

@@ -1,19 +0,0 @@
-export type FilterCategory = 'broken' | 'cycles' | 'deleted';
-export interface FilterDataSources {
-    /** Component keys that participate in a slot cycle. */
-    cycles?: Iterable<string>;
-    /** Component keys the step considers "broken" (issue/warning/AI-flagged). */
-    broken?: Iterable<string>;
-    /** Component keys marked for deletion (GenerateReview only). */
-    deleted?: Iterable<string>;
-}
-export declare function computeFilterKeys(input: {
-    filters: Iterable<FilterCategory>;
-    data: FilterDataSources;
-}): Set<string> | undefined;
-export declare function intersectFilterKeys(a: Set<string> | undefined, b: Set<string> | undefined): Set<string> | undefined;
-export declare function buildFlatDimPredicate(input: {
-    viewMode: 'grouped' | 'flat';
-    searchQuery: string;
-    filterVisibleKeys: Set<string> | undefined;
-}): ((componentKey: string) => boolean) | undefined;

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

@@ -1,10 +0,0 @@
-import React from 'react';
-type ErrorStepProps = {
-    stepName: string;
-    message: string;
-    onExit: () => void;
-    onRetryCredentials?: () => void;
-    onAcknowledgeBreakingChanges?: () => void;
-};
-export declare function ErrorStep({ stepName, message, onExit, onRetryCredentials, onAcknowledgeBreakingChanges, }: ErrorStepProps): 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/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/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[]>;