@contentful/experience-design-system-cli 2.34.5-dev-build-ea694b2.0 → 2.34.5-dev-build-57e4802.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.34.5-dev-build-ea694b2.0",
+  "version": "2.34.5-dev-build-57e4802.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/analyze/composition/interchange-schema.d.ts

@@ -1,11 +1,17 @@
 /**
  * The CLI-owned composition interchange format (spec T1).
  *
- * `CompositionEdge[]` is the flat internal runtime view, one edge per
- * parent→child relationship, carrying optional `slot` (T7), `confidence`,
- * and `provenance`. It is easier to merge and dedupe across sources (T2).
+ * Two views of the same data:
+ *  - `InterchangeMap` — the human-authored / on-disk `{ version, groups }`
+ *    shape (parent → children), consumed by the composition-map option.
+ *    `--composition-map` consumes and the resolver can emit.
+ *  - `CompositionEdge[]` — the flat internal runtime view, one edge per
+ *    parent→child relationship, carrying optional `slot` (T7), `confidence`,
+ *    and `provenance`. Easier to merge/dedupe across sources (T2).
+ *
+ * This module owns both shapes and the converters between them.
  */
-export type EdgeProvenance = 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
+export type EdgeProvenance = 'user' | 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
 export type CompositionEdge = {
     parent: string;
     child: string;
@@ -15,3 +21,17 @@ export type CompositionEdge = {
     confidence?: number;
     provenance: EdgeProvenance;
 };
+export type InterchangeMap = {
+    version: 1;
+    groups: Record<string, string[]>;
+};
+export type ValidateResult = {
+    valid: true;
+    map: InterchangeMap;
+} | {
+    valid: false;
+    errors: string[];
+};
+export declare function validateInterchangeMap(input: unknown): ValidateResult;
+export declare function groupsToEdges(map: InterchangeMap, provenance: EdgeProvenance): CompositionEdge[];
+export declare function edgesToGroups(edges: CompositionEdge[]): InterchangeMap;

package/dist/src/analyze/composition/resolve-mapping-cli.d.ts

@@ -1,7 +1,18 @@
+import { type InterchangeMap } from './interchange-schema.js';
 export type CompositionCliOptions = {
+    /** `--composition-map <path>` — hand-authored interchange file. */
+    compositionMap?: string;
     /** `--composition-refresh` — force edge emission to run even over resolved residue. */
     compositionRefresh?: boolean;
 };
+export type LoadUserMapResult = {
+    ok: true;
+    map: InterchangeMap;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function loadUserMap(path: string): Promise<LoadUserMapResult>;
 export type ResolvedCompositionSources = {
     forceAgent: boolean;
 };

package/dist/src/analyze/composition/resolve-mapping.d.ts

@@ -1,8 +1,9 @@
 import type { RawComponentDefinition } from '../../types.js';
-import type { CompositionEdge } from './interchange-schema.js';
+import { type CompositionEdge, type InterchangeMap } from './interchange-schema.js';
 import { type EdgeConflict } from './merge-edges.js';
 export type ResolveMappingResult = {
     components: RawComponentDefinition[];
+    userMap?: InterchangeMap;
     edges: CompositionEdge[];
     conflicts: EdgeConflict[];
     warnings: string[];
@@ -10,9 +11,9 @@ export type ResolveMappingResult = {
 /**
  * Orchestrate composition-edge acquisition and enrichment.
  *
- * Sources by rank: typed-slot / "code slots" (2) > structural usage evidence
- * (3) > manifest (4) > doc (5) > adapter-resolved / extraEdges (6) >
- * edge-emitting agent (7). Manifest/doc edges are computed deterministically outside
+ * Sources by rank: user map (1) > typed-slot / "code slots" (2) > structural
+ * usage evidence (3) > manifest (4) > doc (5) > adapter-resolved / extraEdges
+ * (6) > edge-emitting agent (7). Manifest/doc edges are computed deterministically outside
  * this function (see manifest-doc-evidence.ts) and joined via `extraEdges`.
  * ALL sources — including the code slots already on the incoming components —
  * are fed into one ranked merge and unioned; non-conflicting edges from every
@@ -27,6 +28,7 @@ export type ResolveMappingResult = {
  */
 export declare function resolveMapping(input: {
     components: RawComponentDefinition[];
+    userMap?: InterchangeMap;
     forceAgent?: boolean;
     files: Array<{
         path: string;
@@ -53,7 +55,7 @@ export declare function resolveMapping(input: {
     /**
      * Pre-resolved edges from an external source (e.g. manifest or documentation)
      * path). They join the ranked merge at their own provenance rank alongside
-     * code slots and other automatic mapping sources.
+     * code slots and the user map.
      */
     extraEdges?: CompositionEdge[];
 }): Promise<ResolveMappingResult>;

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

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

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

@@ -17,7 +17,6 @@ export declare function buildGenerateTokensArgs(opts: {
     model?: string;
     bedrock?: boolean;
     noCache?: boolean;
-    promptOverrides?: string[];
 }): string[];
 export declare function buildMapTokensArgs(opts: {
     sessionId: string;
@@ -25,7 +24,6 @@ export declare function buildMapTokensArgs(opts: {
     model?: string;
     noCache?: boolean;
     skipAgent?: boolean;
-    promptOverrides?: string[];
     existingEntitiesPath?: string;
 }): string[];
 export declare function shouldRunMapTokens(opts: {
@@ -53,6 +51,7 @@ export type WizardAppProps = {
     bedrock?: boolean;
     initialProjectPath?: string;
     host?: string;
+    compositionMap?: string;
     promptOverrides?: string[];
     noCache?: boolean;
     livePreview?: boolean;
@@ -60,4 +59,4 @@ export type WizardAppProps = {
     skipMapTokens?: boolean;
     initialRawTokensPath?: string;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, compositionMap, promptOverrides, noCache, livePreview, generatePromptPath, skipMapTokens, initialRawTokensPath, }?: WizardAppProps): React.ReactElement;

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

@@ -1,7 +1,18 @@
 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 | null;
+    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;
+};
 export declare function sortComponentsForSidebar<T extends {
     key: string;
     entry: CDFComponentEntry;
@@ -23,4 +34,4 @@ export interface BreakingRow {
 }
 export declare function buildBreakingRows(breakingChanges: BreakingComponent[]): BreakingRow[];
 export declare function deriveBreakingChanges(response: ServerPreviewResponse): BreakingComponent[];
-export declare function GenerateReviewStep({ extractSessionId, tokenSessionId, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, }: GenerateReviewStepProps): React.ReactElement;
+export declare function GenerateReviewStep(props: GenerateReviewStepProps): React.ReactElement;

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

@@ -25,7 +25,7 @@ export type ScopeGateStepProps = {
     aiFilterError?: string | null;
     onCancelAutoFilter?: () => void;
 };
-export declare function ScopeGateStep({ components, onConfirm, onQuit }: ScopeGateStepProps): React.ReactElement;
+export declare function ScopeGateStep(props: ScopeGateStepProps): React.ReactElement;
 export declare function sideColumnLabelStyle(input: {
     isCycle: boolean;
     isSelected: boolean;