@contentful/experience-design-system-cli 2.37.1-dev-build-34dbca05.0 → 2.37.1-dev-build-ced30421.0

package/dist/package.json

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

package/dist/src/tui/import/steps/07-scope-gate/keymap.d.ts

@@ -80,5 +80,7 @@ export type GateAction = {
     type: 'toggle-jump-filter';
 } | {
     type: 'toggle-view';
+} | {
+    type: 'undo';
 };
 export declare function resolveKey(mode: GateMode, key: KeyPress, ctx: GateContext): GateAction;

package/dist/src/tui/import/steps/07-scope-gate/sidebar/components/GroupedSidebar.d.ts

@@ -45,6 +45,8 @@ export interface VisibleRow {
     cycleChild?: boolean;
     itemIdx: number;
     rootName?: string;
+    /** The parent whose slot the nested row sits in. */
+    parentName?: string;
 }
 export declare function buildVisibleRows(props: {
     items: GroupedSidebarItem[];

package/dist/src/tui/import/steps/07-scope-gate/state.d.ts

@@ -1,5 +1,5 @@
 import { type ScopeGraph } from './graph/index.js';
-import type { Decision, ScopeComponent, ScopeDecisions } from './types.js';
+import type { Decision, ParentChildEdge, ScopeComponent, ScopeDecisions } from './types.js';
 export type DecisionState = Map<string, Decision>;
 export type DecisionAction = {
     type: 'accept';
@@ -15,5 +15,6 @@ export type DecisionAction = {
 export declare function reduceDecisions(state: DecisionState, action: DecisionAction, components: ScopeComponent[], graph: ScopeGraph): DecisionState;
 /** Whether rejecting `name` touches 2 or more other components, so the screen has to ask first. */
 export declare function rejectNeedsConfirmation(graph: ScopeGraph, name: string, state: DecisionState): boolean;
+export declare function withoutSlotChildren(components: ScopeComponent[], removedEdges: ParentChildEdge[]): ScopeComponent[];
 /** Everything not accepted counts as rejected, as legacy's `partition` did. */
-export declare function partitionDecisions(components: ScopeComponent[], state: DecisionState): ScopeDecisions;
+export declare function partitionDecisions(components: ScopeComponent[], state: DecisionState, removedEdges: ParentChildEdge[]): ScopeDecisions;

package/dist/src/tui/import/steps/07-scope-gate/types.d.ts

@@ -10,10 +10,17 @@ export type ScopeComponent = Omit<ScopeComponentRow, 'aiDecision' | 'aiReason' |
     slots?: ScopeComponentRow['slots'];
 };
 export type Decision = 'accepted' | 'rejected' | 'undecided';
+/** One slot edge: `parent` allows `child` in a slot. */
+export interface ParentChildEdge {
+    parent: string;
+    child: string;
+}
 /** What the user confirmed. Becomes `ImportHandoff.scope`; the legacy wizard saves it and starts generation. */
 export interface ScopeDecisions {
     accepted: string[];
     rejected: string[];
+    /** Slot edges removed at the gate. The child keeps its own decision. Missing means none were removed. */
+    excludedSlotEdges?: ParentChildEdge[];
 }
 export type ScopeGateLoad = {
     ok: true;

package/dist/src/tui/import/steps/07-scope-gate/use-scope-gate.d.ts

@@ -10,7 +10,7 @@ export interface PendingRejectCascade {
     ancestors: string[];
     descendants: string[];
 }
-export declare function useScopeGate({ components, onConfirm, onQuit }: UseScopeGateOptions): {
+export declare function useScopeGate({ components: loadedComponents, onConfirm, onQuit }: UseScopeGateOptions): {
     totalWidth: number;
     columnPlan: {
         layout: "single" | "two-column";

package/dist/src/tui/import/steps/08-generation/types.d.ts

@@ -1,11 +1,9 @@
 import type { GenerationHandoff } from '@contentful/experience-design-system-types/handoff';
+import type { ScopeDecisions } from '../07-scope-gate/types.js';
 export interface GenerationInput {
     /** The extraction session the scope was decided on. */
     sessionId: string;
-    decisions: {
-        accepted: string[];
-        rejected: string[];
-    };
+    decisions: ScopeDecisions;
     /**
      * The cache check that ran while the scope gate was open, which restores cached definitions into the pipeline
      * database. The stage waits for it before saving the decisions, since both write to that database.

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

@@ -0,0 +1,6 @@
+import type { ApplyOperationResponse } from '@contentful/experience-design-system-types';
+import type { ImportApiClient } from '../apply/api-client.js';
+/** Record apply/preview API outcomes on the active command. */
+export declare function recordApplyOutcome(client: ImportApiClient, spaceId: string, environmentId: string, operation: ApplyOperationResponse): void;
+/** Record Contentful target context without an apply operation (e.g. preview-only). */
+export declare function recordContentfulContext(client: ImportApiClient, spaceId: string, environmentId: string): void;

package/legacy/dist/src/analytics/client.d.ts

@@ -0,0 +1,8 @@
+export declare function cliVersion(): string;
+export declare function setPersistedAnalyticsDisabled(disabled: boolean): void;
+export declare function analyticsEnabled(): boolean;
+export declare function trackEvent(event: string, properties: Record<string, unknown>, anonymousId: string, options?: {
+    flush?: boolean;
+}): Promise<void>;
+export declare function flushAnalytics(): Promise<void>;
+export declare function resetAnalyticsClientForTests(): void;

package/legacy/dist/src/analytics/constants.d.ts

@@ -0,0 +1,4 @@
+/** Parent pipeline session id propagated to subprocesses. */
+export declare const ANALYTICS_SESSION_ENV = "EDS_ANALYTICS_SESSION_ID";
+/** Set when a command is spawned by another CLI command. */
+export declare const IMPORT_PIPELINE_ENV = "EDS_IMPORT_PIPELINE";

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

@@ -1,4 +1,4 @@
-import { type CommandFailure } from '@contentful/experience-design-system-backend-pipeline';
 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;

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

@@ -1,3 +1,6 @@
-export { bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, flushAnalytics, isPipelineAnalyticsChild, noteCommandStart, recordApplyOutcome, recordContentfulContext, setCliVersion, setPersistedAnalyticsDisabled, } from '@contentful/experience-design-system-backend-pipeline';
-export type { CommandFailure } from '@contentful/experience-design-system-backend-pipeline';
 export { exitWithAnalytics, failureFromApiError } from './exit.js';
+export { flushAnalytics, setPersistedAnalyticsDisabled } from './client.js';
+export { isPipelineAnalyticsChild } from './session.js';
+export { bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, noteCommandStart, } from './tracker.js';
+export { recordApplyOutcome, recordContentfulContext } from './apply.js';
+export type { CommandFailure } from './types.js';

package/legacy/dist/src/analytics/normalize.d.ts

@@ -0,0 +1,3 @@
+import type { DsiCliCommand } from './types.js';
+/** Map a Commander command chain (e.g. "apply") to a tracked command id, if any. */
+export declare function normalizeCommand(commandChain: string): DsiCliCommand | undefined;

package/legacy/dist/src/analytics/os.d.ts

@@ -0,0 +1,2 @@
+import type { OsName } from './types.js';
+export declare function getOsName(): OsName;

package/legacy/dist/src/analytics/session.d.ts

@@ -0,0 +1,3 @@
+/** Prefer the pipeline parent session, then an explicit id, then a new slug. */
+export declare function resolveAnalyticsSessionId(explicit?: string): string;
+export declare function isPipelineAnalyticsChild(): boolean;

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

@@ -0,0 +1,16 @@
+import type { CommandCompletion, CommandContext, CommandFailure, EntryCommand } from './types.js';
+/** Record the start of a tracked command. Invoked is deferred until a session is bound. */
+export declare function noteCommandStart(commandChain: string): void;
+/** Bind a session id, preferring a pipeline parent id when present. */
+export declare function bindAnalyticsSessionId(sessionId: string | undefined, context?: CommandContext): Promise<string>;
+/** Attach Contentful target context for the active command. */
+export declare function setCommandContext(context: CommandContext): void;
+/** Merge optional completion fields before the terminal event fires. */
+export declare function enrichCommandResult(fields: CommandCompletion): void;
+/** 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. */
+export declare function emitSessionStarted(entryCommand: EntryCommand): Promise<void>;
+export declare function completeActiveCommand(): Promise<void>;
+export declare function failActiveCommand(fields?: CommandFailure): Promise<void>;
+export declare function resetAnalyticsStateForTests(): void;

package/legacy/dist/src/analytics/types.d.ts

@@ -0,0 +1,28 @@
+/** Tracked CLI commands — closed set aligned with the published event schema. */
+export type DsiCliCommand = 'analyze_extract' | 'analyze_select' | 'generate_components' | 'generate_tokens' | 'map_tokens' | 'apply_push' | 'print_components' | 'print_tokens' | 'import';
+export type EntryCommand = 'analyze_extract' | 'import';
+export type OsName = 'macOS' | 'Linux' | 'Windows' | 'Android' | 'other';
+export type WriteResult = {
+    created_count: number;
+    updated_count: number;
+    failed_count: number;
+};
+export type CommandContext = {
+    space_key?: string;
+    environment_key?: string;
+    x_contentful_request_id?: string;
+};
+export type CommandCompletion = CommandContext & {
+    dsi_operation_id?: string;
+    extracted_component_count?: number;
+    accepted_component_count?: number;
+    component_type_result?: WriteResult;
+    design_token_result?: WriteResult;
+};
+export type CommandFailure = CommandContext & {
+    dsi_operation_id?: string;
+    error_name?: string;
+    error_code?: string;
+    http_status_code?: number;
+    exit_code?: number;
+};