@contentful/experience-design-system-cli 2.32.1-dev-build-b78fe18.0 → 2.32.1-dev-build-d28a6f8.0

package/dist/package.json

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

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

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

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

@@ -0,0 +1,29 @@
+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/dist/src/helpers/fetch-existing-contentful-entities.d.ts

@@ -0,0 +1,11 @@
+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/dist/src/helpers/find-nearly-matching-component.d.ts

@@ -0,0 +1,7 @@
+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/dist/src/helpers/read-existing-contentful-entities-from-session.d.ts

@@ -0,0 +1,7 @@
+import type { ExistingContentfulEntities } from './fetch-existing-contentful-entities.js';
+/**
+ * Read the session file the orchestrator writes 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/dist/src/helpers/summarize-existing-contentful-entities.d.ts

@@ -0,0 +1,50 @@
+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/dist/src/import/orchestrator.d.ts

@@ -28,7 +28,6 @@ export interface PipelineOptions {
     /** When true, auto-reject cycle participants and retry push instead of surfacing an error. */
     autoRejectCycles?: boolean;
     allowDeletions?: boolean;
-    withSpaceContext?: boolean;
     compositionMode?: CompositionMode;
     compositionMap?: string;
     compositionAgent?: boolean;

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

@@ -10,6 +10,7 @@ export declare function buildSelectAgentArgs(opts: {
     bedrock?: boolean;
     selectPromptPath?: string;
     noCache?: boolean;
+    existingEntitiesPath?: string;
 }): string[];
 export type AutoFilterProgress = {
     n: number;
@@ -27,6 +28,7 @@ export declare function buildGenerateComponentsArgs(opts: {
     bedrock?: boolean;
     noCache?: boolean;
     generatePromptPath?: string;
+    existingEntitiesPath?: string;
 }): string[];
 export declare function buildMapTokensArgs(opts: {
     sessionId: string;
@@ -34,6 +36,7 @@ export declare function buildMapTokensArgs(opts: {
     model?: string;
     noCache?: boolean;
     skipAgent?: boolean;
+    existingEntitiesPath?: string;
 }): string[];
 export declare function shouldRunMapTokens(opts: {
     mappablePropCount: number;