@contentful/experience-design-system-cli 2.34.5-dev-build-5e798cb1.0 → 2.35.0-alpha.0

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

@@ -1,3 +1,4 @@
 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;

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

@@ -0,0 +1,21 @@
+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 = {
+    compositionRefresh?: boolean;
+    compositionMap?: string;
+};
+/**
+ * Resolve the effective composition mode with precedence
+ * `explicit flag > implied source > env > persisted config > default`.
+ * Default is `atomic` (composition OFF); opting into composite mode enables
+ * the hierarchy machinery. Passing a composition source implies composite.
+ */
+export declare function resolveCompositionMode(opts: {
+    composite?: boolean;
+    atomic?: boolean;
+} & CompositionSourceOptions, configMode?: CompositionMode): CompositionMode;

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. */
@@ -44,6 +45,10 @@ export type RunRecord = {
      *  satisfy `RunRecord`; `appendRun` always normalizes a missing value to
      *  null on the way to disk. */
     sourceFingerprint?: SourceFingerprint | null;
+    /** Composition mode the run was produced in, so 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-5e798cb1.0",
+  "version": "2.35.0-alpha.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -40,8 +40,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-5e798cb1.0",
-    "@contentful/experience-design-system-types": "2.34.5-dev-build-5e798cb1.0"
+    "@contentful/experience-design-system-types": "2.35.0-alpha.0",
+    "@contentful/experience-design-system-cli-v2": "2.35.0-alpha.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -53,9 +53,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-5e798cb1.0",
-    "@contentful/experience-design-system-extraction": "2.34.5-dev-build-5e798cb1.0",
-    "@contentful/experience-design-system-generation": "2.34.5-dev-build-5e798cb1.0"
+    "@contentful/experience-design-system-extraction": "2.35.0-alpha.0",
+    "@contentful/experience-design-system-client": "2.35.0-alpha.0",
+    "@contentful/experience-design-system-generation": "2.35.0-alpha.0"
   },
   "repository": {
     "type": "git",