@contentful/experience-design-system-cli 2.34.5-dev-build-0fafac5.0 → 2.34.5-dev-build-d08439d.0

package/dist/src/lib/command-options.d.ts

@@ -1,5 +1,6 @@
 import type { Command } from 'commander';
 export declare function addArtifactInputOptions(cmd: Command): Command;
 export declare function addContentfulTargetOptions(cmd: Command): Command;
+export declare function addCompositionOptions(cmd: Command): Command;
 export declare function addSelectionOptions(cmd: Command): Command;
 export declare function addAllowDeletionsOption(cmd: Command): Command;

package/dist/src/lib/composition-mode.d.ts

@@ -0,0 +1,30 @@
+export declare const COMPOSITION_MODES: readonly ["composite", "atomic"];
+export type CompositionMode = (typeof COMPOSITION_MODES)[number];
+export declare function isCompositionMode(value: string): value is CompositionMode;
+/**
+ * Options that, when present, IMPLY composite mode — passing any of them is a
+ * clear opt-in, so requiring an explicit `--composite` alongside is redundant.
+ */
+export type CompositionSourceOptions = {
+    compositionMap?: string;
+    compositionAgent?: boolean;
+    compositionRefresh?: boolean;
+    generateMap?: string;
+};
+/**
+ * Resolve the effective composition mode with precedence
+ * `explicit flag > implied source > env > persisted config > default`.
+ * Default is `atomic` (composition OFF); `--composite` opts into the hierarchy
+ * machinery.
+ *
+ * `--atomic` is accepted for symmetry and wins when passed — even alongside a
+ * composition source, since it's an explicit "no" that overrides the implicit
+ * opt-in. If both `--composite` and `--atomic` are present, `--composite`
+ * wins. Passing a composition source (`--composition-map/-agent`,
+ * `--composition-refresh`, or `--generate-map`) implies composite without a
+ * separate `--composite`.
+ */
+export declare function resolveCompositionMode(opts: {
+    composite?: boolean;
+    atomic?: boolean;
+} & CompositionSourceOptions, configMode?: CompositionMode): CompositionMode;

package/dist/src/runs/modify-launcher.d.ts

@@ -2,6 +2,7 @@
  * Thin indirection so `runModifyCommand` can be unit-tested without spinning
  * up the real Ink wizard. The production implementation lives here.
  */
+import type { CompositionMode } from '../lib/composition-mode.js';
 export type ModifyLauncherInput = {
     extractSessionId: string;
     generateSessionId: string | null;
@@ -15,6 +16,9 @@ export type ModifyLauncherInput = {
     savePath: string;
     entryStep: 'scope-gate' | 'final-review';
     saveMode: 'overwrite' | 'new' | 'prompt';
+    /** Composition mode from the run record, so the modify wizard resumes in the
+     *  same mode. Omitted → the wizard's default (`atomic`). */
+    compositionMode?: CompositionMode;
     outDirOverride?: string;
     /** Pre-fill space id (from the run record's pushedTo). */
     initialSpaceId?: string;

package/dist/src/runs/store.d.ts

@@ -1,3 +1,4 @@
+import type { CompositionMode } from '../lib/composition-mode.js';
 export declare const RUNS_FILE_VERSION: 3;
 /** Versions this CLI can read. v1 / v2 files are auto-migrated in memory;
  *  new writes always use the latest version. */
@@ -54,6 +55,10 @@ export type RunRecord = {
      *  writers always populate. Added in runs.json v3. Optional for the same
      *  reason as `sourceFingerprint`. */
     savedFingerprint?: SavedFingerprint | null;
+    /** Composition mode the run was produced in, so modify/replay resumes in the
+     *  same mode (`composite` vs `atomic`). Absent on records written before this
+     *  field existed; callers treat a missing value as `atomic` (the default). */
+    compositionMode?: CompositionMode;
     notes?: string;
 };
 export type RunsFile = {

package/dist/src/setup/composition-mode-prompt.d.ts

@@ -0,0 +1,14 @@
+import type { CompositionMode } from '../lib/composition-mode.js';
+/**
+ * Setup prompts for composition (spec T10). Parallels `promptAutoFilterPreference`
+ * — injectable `ask` for TTY-free unit testing.
+ *
+ * (a) Composite-mode default. Default N → atomic (composition OFF); the
+ *     low-surprise default. `--composite` opts in per invocation.
+ */
+export declare function promptCompositeModePreference(ask: (q: string) => Promise<string>, current?: CompositionMode): Promise<CompositionMode>;
+/**
+ * (b) Agentic mapping resolution. Default N — opt-in (it costs tokens and the
+ *     output needs review), and only meaningful in composite mode.
+ */
+export declare function promptAgenticResolutionPreference(ask: (q: string) => Promise<string>, current?: boolean): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.34.5-dev-build-0fafac5.0",
+  "version": "2.34.5-dev-build-d08439d.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -39,8 +39,8 @@
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-cli-v2": "2.34.5-dev-build-0fafac5.0",
-    "@contentful/experience-design-system-types": "2.34.5-dev-build-0fafac5.0"
+    "@contentful/experience-design-system-cli-v2": "2.34.5-dev-build-d08439d.0",
+    "@contentful/experience-design-system-types": "2.34.5-dev-build-d08439d.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -52,9 +52,9 @@
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16",
-    "@contentful/experience-design-system-client": "2.34.5-dev-build-0fafac5.0",
-    "@contentful/experience-design-system-generation": "2.34.5-dev-build-0fafac5.0",
-    "@contentful/experience-design-system-extraction": "2.34.5-dev-build-0fafac5.0"
+    "@contentful/experience-design-system-client": "2.34.5-dev-build-d08439d.0",
+    "@contentful/experience-design-system-extraction": "2.34.5-dev-build-d08439d.0",
+    "@contentful/experience-design-system-generation": "2.34.5-dev-build-d08439d.0"
   },
   "repository": {
     "type": "git",