@contentful/experience-design-system-cli 2.34.3-dev-build-e63f79c.0 → 2.34.3

package/README.md

@@ -36,20 +36,11 @@ All intermediate data flows through a local SQLite session database (`~/.content
 
 ## Composite components & composition
 
-A **composite component** is one that renders other components inside it — a `Card` that slots a `Button` and an `Icon`, a `Tabs` that slots `Tab` panels. When you import composite components, the CLI can populate each slot's `$allowedComponents` so the parent→child relationships survive into Contentful.
-
-### Atomic vs. composite
-
-Imports are **atomic by default** — flat components, no embedded hierarchy. This is the right choice when you just want each component registered on its own. Opt into hierarchy resolution with `--composite` (or any composition flag, which implies it).
-
-| Mode | Flag | Behavior |
-|---|---|---|
-| Atomic | `--atomic` (default) | Flat import; composition stripped before push |
-| Composite | `--composite` | Resolve and import the parent→child hierarchy |
+A **composite component** is one that renders other components inside it — a `Card` that slots a `Button` and an `Icon`, a `Tabs` that slots `Tab` panels. The CLI populates each slot's `$allowedComponents` so the parent→child relationships survive into Contentful.
 
 ### How composition is resolved
 
-Under `--composite`, relationships are resolved from the highest-confidence source available, in this precedence order:
+Relationships are resolved from the highest-confidence source available, in this precedence order:
 
 1. **Typed slots (code)** — slots the source already declares, e.g. React `ReactElement<XProps>` / `children`, Svelte `Snippet<[XProps]>`, or an explicit `@allowedComponents` JSDoc tag. Fully deterministic; picked up automatically.
 2. **Mapping map** — a hand-authored parent→children interchange map you feed with `--composition-map <path>`. Use `--generate-map <path>` to emit a skeleton from whatever was resolved, then hand-edit it and feed it back.
@@ -121,8 +112,8 @@ experiences import [flags]
 ```
 welcome
   ↓
-extracting             — runs analyze extract (atomic by default; resolves composition
-                         under --composite, see below); spawns generate in parallel (prefetch)
+extracting             — runs analyze extract (resolves composition when a source
+                         is provided; see below); spawns generate in parallel (prefetch)
   ↓
 [auto-filter]          — analyze select-agent runs automatically (skip with --no-auto-filter)
   ↓
@@ -181,12 +172,10 @@ Pass `--select-prompt-path <path>` and/or `--generate-prompt-path <path>` to swa
 | `--model <name>`                  | agent default                          | Model name                                                                                                   |
 | `--tokens <path>`                 | —                                      | DTCG `tokens.json` to push alongside generated components                                                    |
 | `--auto-accept-scope`             | off                                    | Accept all extracted components without prompting (required for non-TTY without other headless flags)        |
-| `--atomic`                        | **default**                            | Flat import, no embedded-component hierarchy (composition stripped on push)                                   |
-| `--composite`                     | —                                      | Import the embedded-component hierarchy (any composition flag implies this)                                   |
-| `--composition-map <path>`        | —                                      | Consume a hand-authored parent→children interchange map (implies `--composite`)                              |
-| `--generate-map <path>`           | —                                      | Also write a composition-map skeleton from the resolved composition (implies `--composite`)                  |
-| `--composition-agent`             | —                                      | Opt into agentic resolution when deterministic sources find no groups (implies `--composite`)                |
-| `--composition-refresh`           | —                                      | Bypass the composition cache and re-resolve from scratch, forcing the agent to run (implies `--composite`)   |
+| `--composition-map <path>`        | —                                      | Consume a hand-authored parent→children interchange map                                                      |
+| `--generate-map <path>`           | —                                      | Write a composition-map skeleton from the resolved composition                                                |
+| `--composition-agent`             | —                                      | Opt into agentic resolution when deterministic sources find no groups                                         |
+| `--composition-refresh`           | —                                      | Bypass the composition cache and re-resolve from scratch, forcing the agent to run                            |
 | `--composition-agent-mode <mode>` | `parser`                               | `parser` (agent writes a sandboxed parser) or `edges` (agent lists edges directly)                           |
 | `--prompt <stage=value>`          | —                                      | Override a stage prompt (repeatable); value is a file path or literal text, e.g. `--prompt composition=./p.md` |
 | `--auto-reject-cycles`            | off (fail loud)                        | Auto-reject components in slot cycles and retry, instead of stopping with the cycle path                     |
@@ -285,12 +274,10 @@ experiences analyze extract --project <path> [--dir <src-dir>] [composition flag
 | `--project <path>` | _(required)_ | Path to the project root |
 | `--dir <path>` | `src` (falls back to project root) | Source directory relative to project root |
 | `--resolve-unreachable <mode>` | `auto` | Retry pass for unresolved Svelte `Props` types: `auto`, `always`, or `never` |
-| `--atomic` | **default** | Skip composition resolution — flat components only |
-| `--composite` | — | Resolve embedded-component composition (any composition flag implies this) |
-| `--composition-map <path>` | — | Consume a hand-authored parent→children interchange map (implies `--composite`) |
-| `--generate-map <path>` | — | Write a skeleton interchange map from the resolved composition (implies `--composite`) |
-| `--composition-agent` | — | Opt into agentic resolution when deterministic sources find no groups (implies `--composite`) |
-| `--composition-refresh` | — | Bypass the composition cache and re-resolve from scratch, forcing the agent to run (implies `--composite`) |
+| `--composition-map <path>` | — | Consume a hand-authored parent→children interchange map |
+| `--generate-map <path>` | — | Write a skeleton interchange map from the resolved composition |
+| `--composition-agent` | — | Opt into agentic resolution when deterministic sources find no groups |
+| `--composition-refresh` | — | Bypass the composition cache and re-resolve from scratch, forcing the agent to run |
 | `--composition-agent-mode <mode>` | `parser` | `parser` (agent writes a sandboxed parser — deterministic) or `edges` (agent lists edges directly) |
 | `--agent <name>` | saved by setup | Coding agent for composition resolution: `claude`, `codex`, `opencode`, `cursor`, `copilot` |
 | `--prompt <stage=value>` | — | Override a stage prompt (repeatable); value is a file path or literal text, e.g. `--prompt composition=./p.md` |
@@ -301,7 +288,7 @@ Writes extracted components to the session database and prints `session=<id>` to
 
 The deterministic non-authorable filter drops infrastructure components with no authoring surface (Context providers, refs-only wrappers, etc.); each drop is reported as a warning so the operator can audit.
 
-Extraction is **atomic by default** — flat components, no embedded hierarchy. See [Composite components & composition](#composite-components--composition) for how `--composite` and the composition flags resolve parent→child relationships.
+See [Composite components & composition](#composite-components--composition) for how the composition flags resolve parent→child relationships.
 
 ---
 

package/dist/package.json

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

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

@@ -1,4 +1,3 @@
-import { type CompositionMode } from './lib/composition-mode.js';
 export type ExperiencesCredentials = {
     spaceId: string;
     environmentId: string;
@@ -15,12 +14,6 @@ export type ExperiencesCredentials = {
     debug?: boolean;
     /** Persisted opt-out for anonymous CLI usage analytics, set via `experiences setup`. */
     analyticsDisabled?: boolean;
-    /**
-     * Feature (atomic mode): default composition mode. `atomic` (default) imports
-     * flat components with no embedded-component hierarchy; `composite` opts into
-     * the slot-graph machinery. Resolved `flag > env > this > default`.
-     */
-    compositionMode?: CompositionMode;
 };
 /**
  * Read persisted Contentful credentials.

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

@@ -1,4 +1,3 @@
-import type { CompositionMode } from '../lib/composition-mode.js';
 export interface PipelineOptions {
     project: string;
     out: string;
@@ -28,7 +27,6 @@ export interface PipelineOptions {
     /** When true, auto-reject cycle participants and retry push instead of surfacing an error. */
     autoRejectCycles?: boolean;
     allowDeletions?: boolean;
-    compositionMode?: CompositionMode;
     compositionMap?: string;
     compositionAgent?: boolean;
     compositionAgentMode?: string;

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

@@ -2,7 +2,6 @@ import React from 'react';
 import { type RunPickerSelection } from '../../runs/run-picker.js';
 import type { RunRecord } from '../../runs/store.js';
 import { type ConflictMode } from '../../runs/save-path-resolver.js';
-import type { CompositionMode } from '../../lib/composition-mode.js';
 export declare function buildSelectAgentArgs(opts: {
     sessionId: string;
     agent: string;
@@ -59,7 +58,6 @@ export type WizardAppProps = {
     host?: string;
     autoAcceptScope?: boolean;
     autoRejectCycles?: boolean;
-    compositionMode?: CompositionMode;
     compositionMap?: string;
     compositionAgent?: boolean;
     compositionAgentMode?: string;
@@ -86,4 +84,4 @@ export type WizardAppProps = {
     onRunPicked?: (selection: RunPickerSelection) => void;
     allowDeletions?: boolean;
 };
-export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, autoAcceptScope, autoRejectCycles, compositionMode, compositionMap, compositionAgent, compositionAgentMode, compositionRefresh, generateMap, promptOverrides, noCache, autoFilter, livePreview, noPush, noSave, outDirOverride, onConflictMode, selectPromptPath, generatePromptPath, skipMapTokens, seedExtractSessionId, seedGenerateSessionId, seedTokenSessionId, seedTokensPath, initialStep, initialRawTokensPath, initialRuns, onRunPicked, allowDeletions, }?: WizardAppProps): React.ReactElement;
+export declare function WizardApp({ initialSpaceId, initialEnvironmentId, initialCmaToken, initialHost, initialAgent, initialModel, bedrock, initialProjectPath, host, autoAcceptScope, autoRejectCycles, compositionMap, compositionAgent, compositionAgentMode, compositionRefresh, generateMap, promptOverrides, noCache, autoFilter, livePreview, noPush, noSave, outDirOverride, onConflictMode, selectPromptPath, generatePromptPath, skipMapTokens, seedExtractSessionId, seedGenerateSessionId, seedTokenSessionId, seedTokensPath, initialStep, initialRawTokensPath, initialRuns, onRunPicked, allowDeletions, }?: WizardAppProps): React.ReactElement;

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

@@ -1,10 +1,8 @@
 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'> & {
     extractSessionId: string | null;
     generatedCount: number;
     autoAccept: boolean;
-    compositionMode?: CompositionMode;
 };
-export declare function FinalReviewHost({ extractSessionId, tokenSessionId, generatedCount, autoAccept, compositionMode, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: FinalReviewHostProps): React.ReactElement;
+export declare function FinalReviewHost({ extractSessionId, tokenSessionId, generatedCount, autoAccept, onFinalize, onQuit, livePreview, spaceId, environmentId, cmaToken, host, tokensPath, initialFinalizeError, allowDeletions, }: FinalReviewHostProps): React.ReactElement;

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

@@ -1,12 +1,10 @@
 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 ScopeGateHostProps = {
     components: ReadonlyArray<ScopeComponent>;
     autoAccept: boolean;
-    compositionMode?: CompositionMode;
     onConfirm: (decisions: {
         accepted: string[];
         rejected: string[];
@@ -20,4 +18,4 @@ export type ScopeGateHostProps = {
     aiFilterError?: string | null;
     onCancelAutoFilter?: () => void;
 };
-export declare function ScopeGateHost({ components, autoAccept, compositionMode, onConfirm, onQuit, aiFilterStatus, aiFilterProgress, aiFilterError, onCancelAutoFilter, }: ScopeGateHostProps): React.ReactElement;
+export declare function ScopeGateHost({ components, autoAccept, onConfirm, onQuit, aiFilterStatus, aiFilterProgress, aiFilterError, onCancelAutoFilter, }: ScopeGateHostProps): React.ReactElement;