@contentful/experience-design-system-cli 2.37.1-dev-build-ef8b693f.0 → 2.37.1-dev-build-a7704a7f.0

package/legacy/dist/src/analyze/select/tui/hooks/useKeymap.d.ts

@@ -1,24 +0,0 @@
-type KeymapContext = {
-    sidebarFocused: boolean;
-    editMode: boolean;
-    dialogOpen: boolean;
-    disabled: boolean;
-};
-type KeymapHandlers = {
-    onSidebarUp: () => void;
-    onSidebarDown: () => void;
-    onSidebarSelect: () => void;
-    onAccept: () => void;
-    onReject: () => void;
-    onEnterEditMode: () => void;
-    onToggleSource: () => void;
-    onScrollUp: () => void;
-    onScrollDown: () => void;
-    onToggleFocus: () => void;
-    onApproveAll: () => void;
-    onFinalize: () => void;
-    onQuit: () => void;
-    onToggleHelp: () => void;
-};
-export declare function useKeymap(context: KeymapContext, handlers: KeymapHandlers): void;
-export {};

package/legacy/dist/src/analyze/select/tui/hooks/useSession.d.ts

@@ -1,19 +0,0 @@
-import type { ReviewSessionPaths, ReviewSessionSnapshot } from '../../types.js';
-type UseSessionInput = {
-    sessionId: string;
-    artifactsRoot: string;
-    reviewRoot?: string;
-};
-type UseSessionResult = {
-    session: ReviewSessionSnapshot | null;
-    paths: ReviewSessionPaths | null;
-    loading: boolean;
-    error: string | null;
-    saveState: (updatedSession: ReviewSessionSnapshot) => Promise<void>;
-    appendEvent: (event: {
-        type: string;
-        payload: Record<string, unknown>;
-    }) => Promise<void>;
-};
-export declare function useSession({ sessionId, artifactsRoot, reviewRoot }: UseSessionInput): UseSessionResult;
-export {};

package/legacy/dist/src/analyze/select/tui/hooks/useUndo.d.ts

@@ -1,8 +0,0 @@
-export type UseUndoResult<T> = {
-    current: T;
-    push: (next: T) => void;
-    undo: () => void;
-    canUndo: boolean;
-    clear: () => void;
-};
-export declare function useUndo<T>(initial: T, maxSize?: number): UseUndoResult<T>;

package/legacy/dist/src/analyze/select/types.d.ts

@@ -1,54 +0,0 @@
-import type { RawComponentDefinition } from '../../types.js';
-export type PreviewAnnotation = 'new' | 'changed' | 'removed' | 'breaking';
-export type ReviewComponentStatus = 'needs-review' | 'reviewed' | 'accepted' | 'rejected';
-export type ReviewComponentRecord = {
-    id: string;
-    name: string;
-    resolvedSourcePath: string;
-    sourceCode: string | null;
-    originalProposal: RawComponentDefinition;
-    editedProposal: RawComponentDefinition;
-    status: ReviewComponentStatus;
-};
-export type ReviewComponentDetail = {
-    id: string;
-    name: string;
-    originalProposal: RawComponentDefinition;
-    editedProposal: RawComponentDefinition;
-    status: ReviewComponentStatus;
-};
-export type ReviewComponentSummary = {
-    id: string;
-    name: string;
-    status: ReviewComponentStatus;
-    previewAnnotation?: PreviewAnnotation;
-    extractionConfidence: number | null;
-    needsReview: boolean;
-    validationErrorCount: number;
-    validationWarningCount: number;
-};
-export type ReviewSessionSnapshot = {
-    components: ReviewComponentRecord[];
-};
-export type ReviewSessionDetail = {
-    components: ReviewComponentDetail[];
-};
-export type ReviewSessionSummary = {
-    components: ReviewComponentSummary[];
-};
-export type ReviewEvent = {
-    type: string;
-    timestamp: string;
-    payload: Record<string, unknown>;
-};
-export type ReviewSessionPaths = {
-    sessionDir: string;
-    eventsPath: string;
-    statePath: string;
-};
-export declare function countValidationIssues(component: RawComponentDefinition): {
-    errors: number;
-    warnings: number;
-};
-export declare function createReviewSessionSummary(session: ReviewSessionSnapshot): ReviewSessionSummary;
-export declare function createReviewSessionDetail(session: ReviewSessionSnapshot): ReviewSessionDetail;

package/legacy/dist/src/analyze/selection-cascade.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentGraphNode } from './composite-closure.js';
-export declare function computeRejectCascade(target: string, components: ComponentGraphNode[]): Set<string>;
-export declare function computeAcceptCascade(target: string, components: ComponentGraphNode[]): Set<string>;

package/legacy/dist/src/analyze/slot-graph.d.ts

@@ -1,11 +0,0 @@
-import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-import type { ComponentGraphNode } from './composite-closure.js';
-export interface SlotGraphInput {
-    key: string;
-    entry: CDFComponentEntry;
-    status?: string;
-}
-export interface BuildOptions {
-    stripRejectedEdges?: boolean;
-}
-export declare function buildComponentGraph(components: SlotGraphInput[], opts?: BuildOptions): ComponentGraphNode[];

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

@@ -1,64 +0,0 @@
-import type { CDFDocument, ServerPreviewResponse, ApplyOperationResponse } from '@contentful/experience-design-system-types';
-export declare const PREVIEW_ERROR_PREFIX = "preview failed:";
-export declare const APPLY_ERROR_PREFIX = "apply failed:";
-export interface ApiClientOptions {
-    host?: string;
-    cmaToken: string;
-    spaceId: string;
-    environmentId: string;
-    retry?: {
-        maxAttempts?: number;
-        initialDelayMs?: number;
-        maxDelayMs?: number;
-        sleep?: (delayMs: number) => Promise<void>;
-    };
-}
-export declare class ApiError extends Error {
-    readonly status: number;
-    readonly body: string;
-    readonly guidance?: string | undefined;
-    constructor(message: string, status: number, body: string, guidance?: string | undefined);
-}
-export interface PreviewValidationError {
-    componentName: string;
-    path: string;
-    message: string;
-}
-/**
- * Parse the JSON body of a 422 from `previewImport()` into structured
- * per-component validation errors. Returns [] for any malformed input
- * so callers can fall back to the generic error path without try/catch.
- *
- * Path shape: `manifest:components/<Name>/$slots/<key>` or
- * `manifest:components/<Name>/$properties/<key>`. Only the component
- * name is extracted today; `path` and `message` are kept verbatim so
- * future diagnostic surfaces can render
- * the field-level detail.
- */
-export declare function parsePreviewValidationErrors(body: string): PreviewValidationError[];
-export declare class ImportApiClient {
-    private host;
-    private token;
-    private spaceId;
-    private environmentId;
-    private retry;
-    private lastRequestId?;
-    getLastRequestId(): string | undefined;
-    private noteRequestId;
-    constructor(opts: ApiClientOptions);
-    private base;
-    private headers;
-    private requestWithRetry;
-    validateToken(): Promise<void>;
-    checkPreflight(): Promise<void>;
-    previewImport(cdf: CDFDocument): Promise<ServerPreviewResponse>;
-    applyImport(cdf: CDFDocument, options: {
-        acknowledgeBreakingChanges: boolean;
-    }): Promise<ApplyOperationResponse>;
-    pollOperation(operationId: string, opts?: {
-        intervalMs?: number;
-        maxIntervalMs?: number;
-        maxAttempts?: number;
-        onProgress?: (op: ApplyOperationResponse) => void;
-    }): Promise<ApplyOperationResponse>;
-}

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

@@ -1,43 +0,0 @@
-import type { Command } from 'commander';
-import type { CDFComponentEntry, CDFTokenEntry, CDFValidationError, DTCGTokenEntry } from '@contentful/experience-design-system-types';
-import { findSlotCycles } from '../analyze/cycle-detection.js';
-import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
-export declare function readTokensFromPath(flag: string, p: string): Promise<DTCGTokenEntry[]>;
-/** Adapts flat DTCGTokenEntry[] (path alongside the leaf) into the
- * {path, entry} pairs buildCDF/buildFilteredCDF expect. */
-export declare function toCDFTokens(tokens: DTCGTokenEntry[]): Array<{
-    path: string;
-    entry: CDFTokenEntry;
-}>;
-export declare function detectSlotCycles(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>): ReturnType<typeof findSlotCycles>;
-export declare function formatSlotCycleReport(cycles: ReturnType<typeof findSlotCycles>): string[];
-export declare function assertNoSlotCycles(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>): Promise<void>;
-/**
- * Client-side pre-flight for `$allowedComponents` references that are absent
- * from this document, so a typo'd or renamed reference fails fast instead of
- * waiting on the `previewImport`/`applyImport` round-trip. Only catches
- * document-internal misses — a name that resolves against an *existing*
- * target-environment Component still needs the network round-trip to
- * confirm, so this cannot replace the server-side check.
- *
- * `validateSlotReferences` is the detection step (shared with
- * `WizardApp.tsx` via `formatUnresolvedSlotReferences` below, mirroring how
- * `detectSlotCycles`/`formatSlotCycleReport` split for the cycle check).
- */
-export declare function formatUnresolvedSlotReferences(errors: CDFValidationError[]): string[];
-export declare function assertNoUnresolvedSlotReferences(components: Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>): Promise<void>;
-export declare function extractComponents(cdf: Record<string, unknown> | null | undefined): Array<{
-    key: string;
-    entry: CDFComponentEntry;
-}>;
-export declare function hasBreakingChangesWithImpact(preview: ServerPreviewResponse): boolean;
-export declare function registerApplyCommand(program: Command): void;

package/legacy/dist/src/apply/preview-utils.d.ts

@@ -1,12 +0,0 @@
-import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
-/**
- * True when a preview response describes zero server-side changes across
- * every diff bucket (components, tokens, taxonomies). Used by:
- *   - `experiences apply` (CLI): short-circuit the confirm-and-push step.
- *   - `experiences import` wizard: block finalize when the resulting push
- *     would be a pure no-op.
- *
- * A push that produces ANY entry in ANY bucket — including a rejection that
- * removes a server-side component — is NOT empty.
- */
-export declare function isEmptyPreview(preview: ServerPreviewResponse): boolean;

package/legacy/dist/src/apply/tokens.d.ts

@@ -1 +0,0 @@
-export { readTokensFromPath, hasBreakingChangesWithImpact, toCDFTokens } from './command.js';

package/legacy/dist/src/apply/tui/ServerApplyView.d.ts

@@ -1,34 +0,0 @@
-import React from 'react';
-import type { ServerPreviewResponse, ApplyOperationResponse } from '@contentful/experience-design-system-types';
-interface ServerPreviewConfirmProps {
-    preview: ServerPreviewResponse;
-    spaceId: string;
-    environmentId: string;
-    breakingWithImpact: boolean;
-    onConfirm: (acknowledge: boolean) => void;
-    onCancel: () => void;
-}
-export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
-interface ServerPreviewAppProps {
-    preview: ServerPreviewResponse;
-    spaceId: string;
-    environmentId: string;
-}
-export declare function ServerPreviewApp({ preview, spaceId, environmentId }: ServerPreviewAppProps): React.ReactElement;
-interface ServerApplyProgressProps {
-    spaceId: string;
-    environmentId: string;
-    status: 'applying' | 'polling' | 'error';
-    operationId?: string;
-    error?: string;
-}
-export declare function ServerApplyProgress({ spaceId, environmentId, status, operationId, error, }: ServerApplyProgressProps): React.ReactElement;
-interface ServerApplyDoneProps {
-    operation: ApplyOperationResponse;
-    spaceId: string;
-    environmentId: string;
-    /** Configured API host (e.g. `api.contentful.com`). Used to derive the post-push webapp URL. */
-    host?: string;
-}
-export declare function ServerApplyDone({ operation, spaceId, environmentId, host }: ServerApplyDoneProps): React.ReactElement;
-export {};

package/legacy/dist/src/apply/tui/ServerPreviewView.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import type { ServerPreviewResponse } from '@contentful/experience-design-system-types';
-interface ServerPreviewViewProps {
-    preview: ServerPreviewResponse;
-    spaceId: string;
-    environmentId: string;
-}
-export declare function ServerPreviewView({ preview, spaceId, environmentId }: ServerPreviewViewProps): React.ReactElement;
-export {};

package/legacy/dist/src/credentials-store.d.ts

@@ -1,18 +0,0 @@
-export type ExperiencesCredentials = {
-    spaceId: string;
-    environmentId: string;
-    cmaToken: string;
-    host?: string;
-    agent?: string;
-    agentModel?: string;
-    /** Feature 8: persisted custom prompt path for `generate components`. */
-    generatePromptPath?: string;
-    /** Write JSONL trace of every command decision to ~/.contentful/experience-design-system-cli/debug/. */
-    debug?: boolean;
-    /** Print plain text with no color; an exported NO_COLOR still wins. */
-    noColor?: boolean;
-    analyticsDisabled?: boolean;
-};
-export declare function readExperiencesCredentials(): Promise<ExperiencesCredentials>;
-export declare function writeExperiencesCredentials(creds: ExperiencesCredentials): Promise<void>;
-export declare function experiencesCredentialsPath(): string;

package/legacy/dist/src/doctor/checks.d.ts

@@ -1,5 +0,0 @@
-export declare function reportNode(): Promise<boolean>;
-export declare function reportPnpm(pkgRoot: string): Promise<boolean>;
-export declare function reportDependencies(pkgRoot: string): Promise<boolean>;
-export declare function reportBuild(pkgRoot: string): Promise<boolean>;
-export declare function reportAgent(): Promise<boolean>;

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

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

package/legacy/dist/src/doctor/report.d.ts

@@ -1,7 +0,0 @@
-export declare function ok(msg: string): void;
-export declare function fail(msg: string): void;
-export declare function warn(msg: string): void;
-export declare function info(msg: string): void;
-export declare function section(title: string): void;
-/** Echo the first `limit` lines of a failed command's stderr. */
-export declare function infoStderr(stderr: string, limit: number): void;

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

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

package/legacy/dist/src/generate/tui/GenerateView.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-export interface GenerateViewResult {
-    skill: string;
-    agent: string;
-    sessionId: string;
-}
-interface GenerateViewProps {
-    result: GenerateViewResult;
-    onExit: () => void;
-}
-export declare function GenerateView({ result, onExit }: GenerateViewProps): React.ReactElement;
-export {};

package/legacy/dist/src/helpers/build-contentful-management-client.d.ts

@@ -1,7 +0,0 @@
-import { type PlainClientAPI } from 'contentful-management';
-interface BuildContentfulManagementClientOptions {
-    cmaToken: string;
-    host?: string;
-}
-export declare function buildContentfulManagementClient(opts: BuildContentfulManagementClientOptions): PlainClientAPI;
-export {};

package/legacy/dist/src/helpers/fetch-and-persist-existing-contentful-entities.d.ts

@@ -1,29 +0,0 @@
-import { type ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
-export interface FetchAndPersistParams {
-    spaceId: string;
-    environmentId: string;
-    cmaToken: string;
-    host?: string;
-    outDir: string;
-}
-export interface FetchAndPersistSuccess {
-    ok: true;
-    path: string;
-    durationMs: number;
-    entities: ExistingContentfulEntities;
-}
-export interface FetchAndPersistFailure {
-    ok: false;
-    durationMs: number;
-    error: string;
-}
-export type FetchAndPersistResult = FetchAndPersistSuccess | FetchAndPersistFailure;
-/**
- * Build the Contentful management client, fetch the target space's Components
- * and DesignTokens, and write the raw payload to `<outDir>/.existing-entities.json`.
- *
- * Never throws — a failure is reported via `ok: false`. Callers own the
- * user-facing step/progress reporting. This helper only handles the mechanical
- * fetch-then-write and returns a structured result.
- */
-export declare function fetchAndPersistExistingContentfulEntities(params: FetchAndPersistParams): Promise<FetchAndPersistResult>;

package/legacy/dist/src/helpers/fetch-existing-contentful-entities.d.ts

@@ -1,11 +0,0 @@
-import { type ComponentProps, type DesignTokenProps, type PlainClientAPI } from 'contentful-management';
-export interface ExistingContentfulEntities {
-    components: ComponentProps[];
-    tokens: DesignTokenProps[];
-}
-interface FetchExistingContentfulEntitiesParams {
-    spaceId: string;
-    environmentId: string;
-}
-export declare function fetchExistingContentfulEntitiesFromContentful(client: PlainClientAPI, params: FetchExistingContentfulEntitiesParams): Promise<ExistingContentfulEntities>;
-export {};

package/legacy/dist/src/helpers/find-nearly-matching-component.d.ts

@@ -1,7 +0,0 @@
-import type { ComponentProps } from 'contentful-management';
-/**
- * Find the space component whose name is closest to the codebase component name,
- * within a small edit budget. Handles case, punctuation, and plural differences
- * so `Btn-Primary` matches `btnPrimary`, and `Cards` matches `Card`.
- */
-export declare function findNearlyMatchingComponent(components: ComponentProps[], codebaseName: string): ComponentProps | undefined;

package/legacy/dist/src/helpers/read-existing-contentful-entities-from-session.d.ts

@@ -1,7 +0,0 @@
-import type { ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
-/**
- * Read the session file written after
- * `fetchExistingContentfulEntitiesFromContentful()`. Returns undefined on
- * any failure — this is optional enrichment and must never block the step.
- */
-export declare function readExistingContentfulEntitiesFromSession(path: string | undefined): Promise<ExistingContentfulEntities | undefined>;

package/legacy/dist/src/helpers/summarize-existing-contentful-entities.d.ts

@@ -1,50 +0,0 @@
-import type { ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
-export interface SelectAgentSummary {
-    components: Array<{
-        id: string;
-        name: string;
-        description: string;
-    }>;
-    tokens: {
-        count: number;
-        kinds: string[];
-    };
-}
-export interface GenerateAgentSummary {
-    likelyMatch?: {
-        id: string;
-        name: string;
-        designProperties: Array<{
-            id: string;
-            name: string;
-            type: string;
-        }>;
-        contentProperties: Array<{
-            id: string;
-            name: string;
-            type: string;
-        }>;
-        slots: Array<{
-            id: string;
-            name: string;
-        }>;
-    };
-    otherComponents: Array<{
-        id: string;
-        name: string;
-    }>;
-    tokens: {
-        count: number;
-        kinds: string[];
-    };
-}
-export interface MapTokensSummary {
-    tokens: Array<{
-        id: string;
-        name: string;
-        type: string;
-    }>;
-}
-export declare function summarizeForSelectAgent(entities: ExistingContentfulEntities): SelectAgentSummary;
-export declare function summarizeForGenerateAgent(entities: ExistingContentfulEntities, codebaseComponentName: string): GenerateAgentSummary;
-export declare function summarizeForMapTokens(entities: ExistingContentfulEntities): MapTokensSummary;

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

@@ -1,3 +0,0 @@
-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/legacy/dist/src/index.d.ts

@@ -1 +0,0 @@
-export {};