@contentful/experience-design-system-cli 2.33.1-dev-build-1b6f259.0 → 2.33.1-dev-build-db909d4.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.33.1-dev-build-1b6f259.0",
+  "version": "2.33.1-dev-build-db909d4.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -47,6 +47,7 @@
     "ink": "^5.2.1",
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
+    "react-dom": "^18.3.1",
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3"

package/dist/src/analytics/env.d.ts

@@ -1,2 +1,4 @@
+/** Merge pipeline analytics env into a subprocess environment. */
+export declare function analyticsEnvForSubprocess(env: NodeJS.ProcessEnv, analyticsSessionId: string): NodeJS.ProcessEnv;
 /** Debug + pipeline analytics env for orchestrator subprocesses. */
 export declare function pipelineSubprocessEnv(env: NodeJS.ProcessEnv, analyticsSessionId: string): NodeJS.ProcessEnv;

package/dist/src/analytics/exit.d.ts

@@ -2,3 +2,4 @@ import type { ApiError } from '../apply/api-client.js';
 import type { CommandFailure } from './types.js';
 export declare function exitWithAnalytics(code: number, fields?: CommandFailure): Promise<never>;
 export declare function failureFromApiError(error: ApiError): CommandFailure;
+export declare function failureFromUnknown(error: unknown): CommandFailure;

package/dist/src/analytics/index.d.ts

@@ -1,6 +1,10 @@
-export { exitWithAnalytics, failureFromApiError } from './exit.js';
-export { flushAnalytics, setPersistedAnalyticsDisabled } from './client.js';
-export { isPipelineAnalyticsChild } from './session.js';
-export { bindAnalyticsSession, bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, noteCommandStart, } from './tracker.js';
+export { ANALYTICS_SESSION_ENV, IMPORT_PIPELINE_ENV } from './constants.js';
+export { analyticsEnvForSubprocess, pipelineSubprocessEnv } from './env.js';
+export { exitWithAnalytics, failureFromApiError, failureFromUnknown } from './exit.js';
+export { analyticsEnabled, cliVersion, flushAnalytics, resetAnalyticsClientForTests, setPersistedAnalyticsDisabled, trackEvent, } from './client.js';
+export { isPipelineAnalyticsChild, resolveAnalyticsSessionId } from './session.js';
+export { normalizeCommand } from './normalize.js';
+export { getOsName } from './os.js';
+export { bindAnalyticsSession, bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, getBoundSessionId, noteCommandStart, resetAnalyticsStateForTests, setCommandContext, } from './tracker.js';
 export { recordApplyOutcome, recordContentfulContext } from './apply.js';
-export type { CommandFailure } from './types.js';
+export type { CommandCompletion, CommandContext, CommandFailure, DsiCliCommand, EntryCommand, OsName, WriteResult, } from './types.js';

package/dist/src/analytics/tracker.d.ts

@@ -7,6 +7,7 @@ export declare function bindAnalyticsSessionId(sessionId: string | undefined, co
 export declare function setCommandContext(context: CommandContext): void;
 /** Merge optional completion fields before the terminal event fires. */
 export declare function enrichCommandResult(fields: CommandCompletion): void;
+export declare function getBoundSessionId(): string | undefined;
 /** Bind the pipeline session and emit invoked once both command and session are known. */
 export declare function bindAnalyticsSession(id: string, context?: CommandContext): Promise<void>;
 /** Emit session_started once per new pipeline head. */

package/dist/src/analyze/build-analyze-view-rows.d.ts

@@ -1,6 +1,17 @@
 import type { RawComponentDefinition } from '../types.js';
 import type { AnalyzeViewResult } from './tui/AnalyzeView.js';
 type AnalyzeViewRow = AnalyzeViewResult['components'][number];
+/**
+ * Convention used by both halves of the warnings split:
+ *   per-component warnings start with `<ComponentName>:` and are attached to
+ *   the matching row by `buildAnalyzeViewRows` below; everything else falls
+ *   through to `partitionGlobalWarnings` and renders at the top of the panel.
+ *
+ * Centralized so the two halves can't drift. If the prefix shape ever changes
+ * (e.g. requiring a space after the colon), update `WARNING_PREFIX_SUFFIX`
+ * and both call sites pick it up.
+ */
+export declare const WARNING_PREFIX_SUFFIX = ":";
 export declare function isWarningForComponent(warning: string, componentName: string): boolean;
 /**
  * Split warnings into "global" (none of the surviving component-name prefixes

package/dist/src/analyze/composite-closure.d.ts

@@ -5,7 +5,7 @@ export interface ComponentGraphNode {
         allowedComponents?: string[];
     }>;
 }
-interface ClosureNode {
+export interface ClosureNode {
     name: string;
     depth: number;
     path: string[];
@@ -23,4 +23,3 @@ export declare function computeClosure(root: string, components: ComponentGraphN
 export declare function computeAllClosures(components: ComponentGraphNode[], selected?: Set<string>): Map<string, Closure>;
 export declare function aggregateStatus(closure: Closure, perNodeStatus: Map<string, NodeStatus>): NodeStatus;
 export declare function findSharedDeps(closures: Map<string, Closure>): Map<string, string[]>;
-export {};

package/dist/src/analyze/issue-inheritance.d.ts

@@ -1,4 +1,8 @@
 import type { Closure, NodeStatus } from './composite-closure.js';
+export interface IssueLocation {
+    component: string;
+    status: NodeStatus;
+}
 export interface RenderStatus {
     status: NodeStatus;
     isOwn: boolean;

package/dist/src/analyze/select/index.d.ts

@@ -0,0 +1,6 @@
+export { registerAnalyzeEditCommand } from './command.js';
+export { loadReviewInput } from './parser.js';
+export { appendReviewEvent, ensureRefineSession, getRefineArtifactsRoot, getRefineSessionPaths, saveReviewState, } from './persistence.js';
+export { formatFinalizeContract } from './stdout.js';
+export type { ReviewComponentRecord, ReviewComponentSummary, ReviewComponentStatus, ReviewEvent, ReviewSessionPaths, ReviewSessionSnapshot, ReviewSessionSummary, } from './types.js';
+export { createReviewSessionSummary } from './types.js';

package/dist/src/analyze/select/stdout.d.ts

@@ -0,0 +1,7 @@
+export type FinalizeContractInput = {
+    sessionDir: string;
+    accepted: number;
+    rejected: number;
+    excluded: number;
+};
+export declare function formatFinalizeContract(input: FinalizeContractInput): string;

package/dist/src/analyze/select/tui/components/ComponentRationalePanel.d.ts

@@ -7,4 +7,20 @@ export type ComponentRationalePanelProps = {
     height: number;
     active: boolean;
 };
+type RenderedLine = {
+    kind: 'heading';
+    text: string;
+} | {
+    kind: 'text';
+    text: string;
+    dim?: boolean;
+} | {
+    kind: 'list-name';
+    text: string;
+    sublabel?: string;
+} | {
+    kind: 'blank';
+};
+export declare function renderComponentRationaleLines(data: ComponentRationale, innerWidth: number): RenderedLine[];
 export declare function ComponentRationalePanel({ data, scrollOffset, width, height, active, }: ComponentRationalePanelProps): React.ReactElement;
+export {};

package/dist/src/analyze/select/tui/components/FieldEditor.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { findSlotCycles, type ComponentSlotInfo } from '../../../cycle-detection.js';
-type PropMetadata = {
+export type PropMetadata = {
     rationale?: string | null;
     sourceStartLine?: number | null;
     sourceEndLine?: number | null;
@@ -13,7 +13,7 @@ export type FieldEditorMetadata = {
     /** Per-prop metadata keyed by prop name. */
     props?: Record<string, PropMetadata>;
 };
-export type FieldEditorProps = {
+type FieldEditorProps = {
     value: string;
     width: number;
     height: number;

package/dist/src/analyze/select/tui/components/RationalePanel.d.ts

@@ -12,4 +12,16 @@ export type RationalePanelProps = {
     height: number;
     active: boolean;
 };
+type RenderedLine = {
+    kind: 'name';
+    text: string;
+    isSlot: boolean;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'blank';
+};
+export declare function renderRationaleLines(rows: RationaleRow[], innerWidth: number): RenderedLine[];
 export declare function RationalePanel({ componentName, rows, scrollOffset, width, height, active, }: RationalePanelProps): React.ReactElement;
+export {};

package/dist/src/analyze/select/tui/components/Sidebar.d.ts

@@ -1,15 +1,11 @@
 import React from 'react';
 import type { PreviewAnnotation, ReviewComponentSummary, ReviewComponentStatus } from '../../types.js';
-export declare function previewBadge(annotation: PreviewAnnotation | undefined): PreviewBadgeValue | null;
-export type PreviewBadgeValue = {
+export declare function previewBadge(annotation: PreviewAnnotation | undefined): {
     char: string;
     color: string;
     bold?: boolean;
     dim?: boolean;
-};
-export declare function PreviewBadge({ badge }: {
-    badge: PreviewBadgeValue | null;
-}): React.ReactElement;
+} | null;
 type SidebarProps = {
     components: ReviewComponentSummary[];
     selectedId: string | null;

package/dist/src/analyze/select/tui/hooks/useImmediateInput.d.ts

@@ -1,4 +1,4 @@
-export type ImmediateInputKey = {
+type Key = {
     upArrow: boolean;
     downArrow: boolean;
     leftArrow: boolean;
@@ -15,5 +15,6 @@ export type ImmediateInputKey = {
     delete: boolean;
     meta: boolean;
 };
-export type ImmediateInputHandler = (input: string, key: ImmediateInputKey) => void;
-export declare function useImmediateInput(handler: ImmediateInputHandler): void;
+type InputHandler = (input: string, key: Key) => void;
+export declare function useImmediateInput(handler: InputHandler): void;
+export {};

package/dist/src/analyze/select/tui/theme.d.ts

@@ -11,4 +11,5 @@ export declare const PALETTE: {
     readonly subtle: "#DDE5EC";
     readonly bg: "#EFF2F6";
 };
+export type PaletteRole = keyof typeof PALETTE;
 export declare function statusPaletteColor(status: ReviewComponentStatus, validationErrorCount: number, validationWarningCount: number): string;

package/dist/src/analyze/select-agent/context-builder.d.ts

@@ -5,18 +5,18 @@ export type SelectionContextSummary = {
     resolverReferenceCount: number;
     hasParentUsageSite: boolean;
 };
-type SelectionImportSummary = {
+export type SelectionImportSummary = {
     source: string;
     names: string[];
     local: boolean;
     resolvedPath?: string;
 };
-type SelectionFileSummary = {
+export type SelectionFileSummary = {
     path: string;
     exports: string[];
     codeSnippet: string;
 };
-type SelectionReference = {
+export type SelectionReference = {
     path: string;
     snippet: string;
 };

package/dist/src/analyze/select-agent/show-rationale.d.ts

@@ -1,3 +1,29 @@
+/**
+ * Read-only rationale view for the `analyze select-agent --show-rationale` flag.
+ *
+ * Reads the rationale data already persisted by a previous `analyze select-agent`
+ * run (component-level decision + reject reason on raw_components; per-prop
+ * rationale on raw_props — both populated by the writer path in command.ts and
+ * the rationale columns added in the schema migration for PR #52). No LLM
+ * invocation, no schema changes.
+ *
+ * Schema-version assertion: if the rationale columns are absent (older DB),
+ * throw with a clear message pointing at the remediation step.
+ */
+export interface RationaleRow {
+    name: string;
+    decision: 'accepted' | 'rejected' | 'needs-review' | 'extracted';
+    reason: string | null;
+}
+/**
+ * Resolves which session to read from. If `sessionFlag` is provided, asserts
+ * the session exists and has at least one raw component; otherwise falls back
+ * to the most recent completed `analyze select` step.
+ */
+export declare function resolveRationaleSession(sessionFlag: string | undefined, dbPath?: string): string;
+export declare function loadRationaleRows(sessionId: string, dbPath?: string): RationaleRow[];
+export declare function formatRationaleTable(rows: RationaleRow[]): string;
+export declare function formatRationaleJson(rows: RationaleRow[]): string;
 /**
  * Top-level dispatch for `analyze select-agent --show-rationale`. Pure I/O
  * boundary: reads DB, writes formatted output to stdout, throws on error.

package/dist/src/apply/api-client.d.ts

@@ -1,4 +1,5 @@
-import type { ManifestPayload, ServerPreviewResponse, ApplyOperationResponse } from '@contentful/experience-design-system-types';
+import type { ManifestPayload, ServerPreviewResponse, ApplyOperationResponse, BreakingChange } from '@contentful/experience-design-system-types';
+export declare const DEFAULT_HOST = "https://api.contentful.com";
 export declare const PREVIEW_ERROR_PREFIX = "preview failed:";
 export declare const APPLY_ERROR_PREFIX = "apply failed:";
 export declare const VALIDATION_FAILED_CODE = "\"ValidationFailed\"";
@@ -37,6 +38,7 @@ export interface PreviewValidationError {
  * the field-level detail.
  */
 export declare function parsePreviewValidationErrors(body: string): PreviewValidationError[];
+export declare function sanitizeBreakingChanges(raw: unknown): BreakingChange[];
 export declare class ImportApiClient {
     private host;
     private token;

package/dist/src/host-utils.d.ts

@@ -1,3 +1,4 @@
+export declare const DEFAULT_API_HOST = "https://api.contentful.com";
 export declare const DEFAULT_CONFIGURED_HOST = "api.contentful.com";
 export declare function toConfiguredHost(host?: string): string | undefined;
 export declare function toApiHost(host?: string): string;

package/dist/src/import/orchestrator.d.ts

@@ -53,6 +53,7 @@ export interface PipelineResult {
         report: string[];
     };
 }
+export declare const SLOT_CYCLE_MARKER = "manifest:components/slot-cycles";
 export declare function isSlotCycleError(result: {
     exitCode: number;
     stderr: string;

package/dist/src/import/picker-dispatch.d.ts

@@ -23,6 +23,4 @@ export type PickerDispatchDeps = {
      */
     pickerPushRun?: typeof pickerPushRunFn;
 };
-export declare function buildPickerCredentialOptions(opts: Pick<PickerDispatchOptions, 'spaceId' | 'environmentId' | 'cmaToken' | 'host' | 'force'>): Pick<PickerDispatchOptions, 'spaceId' | 'environmentId' | 'cmaToken' | 'host' | 'force'>;
-export declare function buildPickerModifyOptions(opts: Pick<PickerDispatchOptions, 'outDir' | 'overwrite' | 'saveAsNew' | 'force'>): Pick<PickerDispatchOptions, 'outDir' | 'overwrite' | 'saveAsNew' | 'force'>;
 export declare function dispatchPickerSelection(selection: RunPickerSelection, opts: PickerDispatchOptions, deps: PickerDispatchDeps): Promise<void>;

package/dist/src/import/print-prompt.d.ts

@@ -13,6 +13,7 @@
  * declarative and lets the deprecation notice be asserted from tests without
  * spawning the full pipeline.
  */
+export declare const DRY_RUN_DEPRECATION_NOTICE: string;
 export type PromptFlags = {
     /** True when the user passed --dry-run. */
     dryRun?: boolean;

package/dist/src/import/tui/auto-filter-error.d.ts

@@ -1 +1,2 @@
+export declare function stripAnsi(s: string): string;
 export declare function buildAutoFilterErrorTail(raw: string): string;

package/dist/src/import/tui/final-review-host.d.ts

@@ -1,10 +1,20 @@
 import React from 'react';
 import type { CompositionMode } from '../../lib/composition-mode.js';
-import type { ReviewStepProps } from './review-step-props.js';
-export type FinalReviewHostProps = Omit<ReviewStepProps, 'extractSessionId'> & {
+export type FinalReviewHostProps = {
     extractSessionId: string | null;
+    tokenSessionId?: string | null;
     generatedCount: number;
     autoAccept: boolean;
     compositionMode?: CompositionMode;
+    onFinalize: (accepted: number, rejected: number, unresolved: number) => void;
+    onQuit: () => void;
+    livePreview?: boolean;
+    spaceId?: string;
+    environmentId?: string;
+    cmaToken?: string;
+    host?: string;
+    tokensPath?: string;
+    initialFinalizeError?: string | null;
+    allowDeletions?: boolean;
 };
 export declare function FinalReviewHost({ extractSessionId, tokenSessionId, generatedCount, autoAccept, compositionMode, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: FinalReviewHostProps): React.ReactElement;

package/dist/src/import/tui/history.d.ts

@@ -5,7 +5,7 @@ export interface HistorySnapshot {
     autoRejected: string[];
     undoSnapshot: Map<string, ReviewComponentStatus> | null;
 }
-interface CdfReviewEntrySnapshot {
+export interface CdfReviewEntrySnapshot {
     key: string;
     entry: CDFComponentEntry;
     status: ReviewComponentStatus;
@@ -20,4 +20,3 @@ export interface HistoryStack {
     size(): number;
 }
 export declare function createHistoryStack(seed: HistorySnapshot, maxDepth?: number): HistoryStack;
-export {};

package/dist/src/import/tui/scope-gate-columns.d.ts

@@ -4,6 +4,7 @@ export interface ScopeComponentLike {
     name: string;
 }
 export type Decision = 'accepted' | 'rejected' | 'undecided';
+export declare const THREE_COLUMN_MIN_WIDTH = 120;
 export declare function computeColumnWidths(totalWidth: number): {
     layout: 'single' | 'three-column';
     main: number;

package/dist/src/import/tui/scope-gate-host.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { ScopeComponent } from './steps/ScopeGateStep.js';
 import type { CompositionMode } from '../../lib/composition-mode.js';
 export type { ScopeComponent };
-type AutoFilterStatus = 'idle' | 'running' | 'complete' | 'cancelled' | 'failed';
+export type AutoFilterStatus = 'idle' | 'running' | 'complete' | 'cancelled' | 'failed';
 export type ScopeGateHostProps = {
     components: ReadonlyArray<ScopeComponent>;
     autoAccept: boolean;

package/dist/src/import/tui/steps/AtomicGenerateReviewStep.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
 type GenerateReviewStepProps = {
     extractSessionId: string;
     tokenSessionId?: string | null;
@@ -24,5 +25,19 @@ type GenerateReviewStepProps = {
      */
     initialFinalizeError?: string | null;
 };
+/**
+ * Sort components for the final-review sidebar so the underlying data array
+ * matches the visual order. Empty components (zero classified $properties)
+ * surface at the top via the warning-tier path in Sidebar.tsx; we mirror that
+ * here so `selectedIdx` indexes into the same order the user sees. Without
+ * this, j/k navigation lands on different rows than the visually-selected
+ * one (INTEG-4259).
+ *
+ * Within each tier (empty / non-empty) we tie-break alphabetically by `key`.
+ */
+export declare function sortComponentsForSidebar<T extends {
+    key: string;
+    entry: CDFComponentEntry;
+}>(components: T[]): T[];
 export declare function AtomicGenerateReviewStep({ extractSessionId, tokenSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: GenerateReviewStepProps): React.ReactElement;
 export {};

package/dist/src/import/tui/steps/GenerateReviewStep.d.ts

@@ -1,7 +1,19 @@
 import React from 'react';
 import type { BreakingChange, CDFComponentEntry, ComponentTypeSummary, DownstreamImpact, ServerPreviewResponse } from '@contentful/experience-design-system-types';
-import type { ReviewStepProps } from '../review-step-props.js';
-type GenerateReviewStepProps = ReviewStepProps;
+type GenerateReviewStepProps = {
+    extractSessionId: string;
+    tokenSessionId?: string | null;
+    onFinalize: (accepted: number, rejected: number, unresolved: number) => void;
+    onQuit: () => void;
+    livePreview?: boolean;
+    spaceId?: string;
+    environmentId?: string;
+    cmaToken?: string;
+    host?: string;
+    tokensPath?: string;
+    initialFinalizeError?: string | null;
+    allowDeletions?: boolean;
+};
 export declare function sortComponentsForSidebar<T extends {
     key: string;
     entry: CDFComponentEntry;

package/dist/src/import/tui/steps/PreviewStep.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+type EntitySummary = {
+    created: number;
+    updated: number;
+    unchanged: number;
+    conflicts: number;
+    failed: number;
+};
+type PreviewStepProps = {
+    componentTypes: EntitySummary;
+    designTokens: EntitySummary;
+    spaceId: string;
+    environmentId: string;
+    stepNumber: number;
+    totalSteps: number;
+    onConfirm: () => void;
+    onSaveFiles?: () => void;
+    onQuit: () => void;
+};
+export declare function PreviewStep({ componentTypes, designTokens, spaceId, environmentId, stepNumber, totalSteps, onConfirm, onSaveFiles, onQuit, }: PreviewStepProps): React.ReactElement;
+export {};

package/dist/src/import/tui/useFinalizePreview.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
-type FinalizePreviewStatus = 'idle' | 'running' | 'done' | 'error';
+export type FinalizePreviewStatus = 'idle' | 'running' | 'done' | 'error';
 export type UseFinalizePreviewOptions = {
     /** True while the Finalize dialog is open. Toggling true (re)fires the preview. */
     open: boolean;
@@ -21,13 +21,6 @@ export type UseFinalizePreviewReturn = {
     /** Adjust the removed-list scroll (clamped to the window). */
     scrollBy: (delta: number) => void;
 };
-export type UseReviewFinalizePreviewOptions = Omit<UseFinalizePreviewOptions, 'acceptedKeys'> & {
-    components: ReadonlyArray<{
-        key: string;
-        status: string;
-    }>;
-};
-export declare function useReviewFinalizePreview({ components, ...options }: UseReviewFinalizePreviewOptions): UseFinalizePreviewReturn;
 /**
  * Shared Finalize-dialog deletion preview, used by both the composite and
  * atomic generate-review steps so the "what will this push delete" experience
@@ -41,4 +34,3 @@ export declare function useReviewFinalizePreview({ components, ...options }: Use
  * simply omits the deletion section.
  */
 export declare function useFinalizePreview(opts: UseFinalizePreviewOptions): UseFinalizePreviewReturn;
-export {};

package/dist/src/import/tui/useLivePreview.d.ts

@@ -15,7 +15,7 @@ export type UseLivePreviewOptions = {
     /** Forwarded verbatim to `runLivePreview`/`previewImport`. */
     allowDeletions?: boolean;
 };
-type LivePreviewStatus = 'idle' | 'running';
+export type LivePreviewStatus = 'idle' | 'running';
 export type UseLivePreviewReturn = {
     trigger: () => void;
     status: LivePreviewStatus;
@@ -38,4 +38,3 @@ export type UseLivePreviewReturn = {
  * is set so we don't accumulate dead timers.
  */
 export declare function useLivePreview(opts: UseLivePreviewOptions): UseLivePreviewReturn;
-export {};