@contentful/experience-design-system-cli 2.35.0-alpha.0 → 2.35.1-dev-build-041b6e0a.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.35.0-alpha.0",
+  "version": "2.35.1-dev-build-041b6e0a.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -9,13 +9,13 @@
     "experiences": "./bin/cli.js",
     "exo": "./bin/cli.js"
   },
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
+  "main": "./dist/index.js",
   "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js",
-      "node": "./dist/src/index.js"
+    ".": "./dist/index.js",
+    "./app": {
+      "types": "./dist/app.d.ts",
+      "import": "./dist/app.js",
+      "node": "./dist/app.js"
     }
   },
   "publishConfig": {
@@ -25,21 +25,19 @@
   "files": [
     "bin/",
     "dist/",
-    "prompts/",
-    "skills/"
+    "legacy/"
   ],
   "scripts": {
     "build": "nx build experience-design-system-cli",
     "typecheck": "nx typecheck experience-design-system-cli",
     "clean": "nx clean experience-design-system-cli",
     "test": "nx test experience-design-system-cli",
-    "test:watch": "nx test:watch experience-design-system-cli",
     "lint": "nx lint experience-design-system-cli",
     "lint:fix": "nx lint:fix experience-design-system-cli"
   },
   "dependencies": {
-    "@contentful/experience-design-system-cli-v2": "workspace:*",
     "@contentful/experience-design-system-types": "workspace:*",
+    "@inkjs/ui": "^2.0.0",
     "@segment/analytics-node": "^3.0.0",
     "@vue/compiler-sfc": "^3.5.31",
     "commander": "^13.1.0",
@@ -48,21 +46,19 @@
     "ink": "^5.2.1",
     "react": "^18.3.1",
     "react-devtools-core": "^4.19.1",
+    "semver": "^7.7.2",
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@contentful/experience-design-system-client": "workspace:*",
-    "@contentful/experience-design-system-extraction": "workspace:*",
-    "@contentful/experience-design-system-generation": "workspace:*",
     "@tsconfig/node24": "^24.0.4",
     "@types/node": "^24.0.3",
     "@types/react": "^18.3.24",
+    "@types/semver": "^7.7.1",
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",
-    "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16"
   },

package/dist/program.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;

package/dist/src/legacy/legacy-cli-path.d.ts

@@ -0,0 +1 @@
+export declare function findLegacyCliPath(): string;

package/dist/src/legacy/run-legacy.d.ts

@@ -0,0 +1 @@
+export declare function runLegacy(args: string[]): Promise<number>;

package/dist/src/tui/debug-store.d.ts

@@ -0,0 +1,14 @@
+type Status = 'success' | 'error';
+type ExitMethod = 'saved' | 'discarded' | 'crashed';
+export declare function startDebugRun({ flow, step, menuOption, inputs, }: {
+    flow: string;
+    step: string;
+    menuOption: string;
+    inputs: Record<string, unknown>;
+}): void;
+export declare function finishDebugRun({ outputs, status, exitMethod, }: {
+    outputs: Record<string, unknown>;
+    status: Status;
+    exitMethod: ExitMethod;
+}): Promise<void>;
+export {};

package/dist/src/tui/help/PageContainer.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function HelpScreen({ onDone }: {
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/home/home.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { Screen } from '../../../app.js';
+export declare function HomeScreen({ onNavigate }: {
+    onNavigate: (screen: Screen) => void;
+}): React.ReactElement;

package/dist/src/tui/home/home.theme.d.ts

@@ -0,0 +1,14 @@
+export declare const PALETTE: {
+    readonly accent: "#1773EB";
+    readonly heading: "#FFFFFF";
+    readonly success: "#00C459";
+    readonly error: "#E44F20";
+    readonly warning: "#FFDA00";
+    readonly muted: "#A6B5C7";
+    readonly border: "#C4D1DE";
+};
+export declare function brandBar(width: number, ramp?: readonly string[]): {
+    text: string;
+    color: string;
+}[];
+export declare const FOCUS_MARKER = "\u276F";

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

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function ImportScreen({ exitCode, onDone }: {
+    exitCode?: number;
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/import/spawn-v1-import.d.ts

@@ -0,0 +1,28 @@
+interface StepResult {
+    step: string;
+    status: 'complete' | 'failed' | 'skipped';
+    durationMs?: number;
+    reason?: string;
+    detail?: Record<string, unknown>;
+    error?: string;
+}
+interface PipelineResult {
+    session: string;
+    project: string;
+    steps: StepResult[];
+    cycleError?: {
+        report: string[];
+    };
+}
+export interface SpawnV1ImportOptions {
+    project?: string;
+    onProgress?: (line: string) => void;
+}
+export interface SpawnV1ImportResult {
+    exitCode: number;
+    result?: PipelineResult;
+    stdout: string;
+    stderr: string;
+}
+export declare function spawnV1Import(options?: SpawnV1ImportOptions): Promise<SpawnV1ImportResult>;
+export {};

package/dist/src/tui/import/terminal-input.d.ts

@@ -0,0 +1,2 @@
+export declare function stopReadingTerminal(): Promise<void>;
+export declare function startReadingTerminal(): void;

package/dist/src/tui/package-root.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Walks up from `startUrl` looking for the outermost ancestor directory whose
+ * `package.json` has `name === packageName`. Keeps walking past the first
+ * match instead of stopping there, because the built CLI's `dist/package.json`
+ * is an unmodified copy of the root manifest and shares the same `name` —
+ * stopping at the first match would land on `dist/` instead of the real
+ * package root. Falls back to the filesystem root if no manifest is found.
+ */
+export declare function findPackageRoot(startUrl: string, packageName: string): string;

package/dist/src/tui/settings/PageContainer.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { Screen } from '../../../app.js';
+export declare function SettingsScreen({ onNavigate, onBack, }: {
+    onNavigate: (screen: Screen) => void;
+    onBack: () => void;
+}): React.ReactElement;

package/dist/src/tui/settings/contentful-configuration/ContentfulConfigScreen.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function ConfigurationScreen({ onDone }: {
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/settings/contentful-configuration/config-store.d.ts

@@ -0,0 +1,9 @@
+export type V1Credentials = {
+    spaceId?: string;
+    environmentId?: string;
+    cmaToken?: string;
+    host?: string;
+    [key: string]: string | undefined;
+};
+export declare function readCredentials(): Promise<V1Credentials>;
+export declare function writeCredentials(config: V1Credentials): Promise<void>;

package/dist/src/tui/settings/debug-mode/debug-mode-store.d.ts

@@ -0,0 +1,5 @@
+export type DebugModeSetting = {
+    enabled: boolean;
+};
+export declare function readDebugModeSetting(): Promise<DebugModeSetting>;
+export declare function writeDebugModeSetting(setting: DebugModeSetting): Promise<void>;

package/dist/src/tui/settings/debug-mode/screen.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function DebugModeScreen({ onDone }: {
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/settings/opt-in-analytics/analytics-store.d.ts

@@ -0,0 +1,5 @@
+export interface AnalyticsSetting {
+    enabled: boolean;
+}
+export declare function readAnalyticsSetting(): Promise<AnalyticsSetting>;
+export declare function writeAnalyticsSetting(setting: AnalyticsSetting): Promise<void>;

package/dist/src/tui/settings/opt-in-analytics/screen.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function OptInAnalyticsScreen({ onDone }: {
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/settings/utils/v1-store.d.ts

@@ -0,0 +1,2 @@
+export declare function readV1Store(): Promise<Record<string, unknown>>;
+export declare function writeV1Store(data: Record<string, unknown>): Promise<void>;

package/dist/src/tui/upgrade/PageContainer.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function UpgradeScreen({ onDone }: {
+    onDone: () => void;
+}): React.ReactElement;

package/dist/src/tui/upgrade/version.d.ts

@@ -0,0 +1,12 @@
+export declare function readPackageVersion(): string;
+export type UpgradeCheckResult = {
+    status: 'update-available';
+    current: string;
+    latest: string;
+} | {
+    status: 'up-to-date';
+    current: string;
+} | {
+    status: 'error';
+};
+export declare function checkForUpgrade(): Promise<UpgradeCheckResult>;

package/dist/src/tui/use-terminal-width.d.ts

@@ -0,0 +1 @@
+export declare function useTerminalWidth(): number;

package/legacy/bin/cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// Suppress the SQLite ExperimentalWarning before any modules load.
+// Must use dynamic import so this handler registers before sqlite is imported.
+process.removeAllListeners("warning");
+process.on("warning", (w) => {
+  if (w.name === "ExperimentalWarning" && w.message.includes("SQLite")) return;
+  process.stderr.write(`${w.name}: ${w.message}\n`);
+});
+
+// Auto-rebuild when running from source (dev mode only).
+// Skipped when src/ doesn't exist (e.g. npm-installed users).
+import { existsSync, statSync, readdirSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve, join } from "node:path";
+
+function newestMtime(dir, depth = 0) {
+  if (depth > 10) return 0;
+  let max = 0;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isSymbolicLink()) continue;
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      max = Math.max(max, newestMtime(full, depth + 1));
+    } else if (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) {
+      max = Math.max(max, statSync(full).mtimeMs);
+    }
+  }
+  return max;
+}
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = resolve(__dirname, "..");
+const srcDir = join(pkgRoot, "src");
+const distEntry = join(pkgRoot, "dist", "src", "index.js");
+
+if (
+  existsSync(srcDir) &&
+  existsSync(distEntry) &&
+  process.env.NODE_ENV !== "test"
+) {
+  const distMtime = statSync(distEntry).mtimeMs;
+  if (newestMtime(srcDir) > distMtime) {
+    process.stderr.write("⚙ Source changed — rebuilding...\n");
+    const tsc = join(pkgRoot, "node_modules", ".bin", "tsc");
+    try {
+      execFileSync(tsc, ["-p", join(pkgRoot, "tsconfig.build.json")], {
+        stdio: ["ignore", "ignore", "inherit"],
+        cwd: pkgRoot,
+      });
+      process.stderr.write("✓ Build complete\n");
+    } catch {
+      process.stderr.write("✗ Build failed — running with existing dist\n");
+    }
+  }
+}
+
+await import("../dist/src/index.js");

package/legacy/dist/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@contentful/experience-design-system-cli-legacy",
+  "version": "2.35.0",
+  "description": "Legacy Contentful Experiences import CLI (internal, not published; used by @contentful/experience-design-system-cli)",
+  "license": "MIT",
+  "private": true,
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "node": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "prompts/",
+    "skills/"
+  ],
+  "scripts": {
+    "build": "nx build experience-design-system-cli-legacy",
+    "typecheck": "nx typecheck experience-design-system-cli-legacy",
+    "clean": "nx clean experience-design-system-cli-legacy",
+    "test": "nx test experience-design-system-cli-legacy",
+    "test:watch": "nx test:watch experience-design-system-cli-legacy",
+    "lint": "nx lint experience-design-system-cli-legacy",
+    "lint:fix": "nx lint:fix experience-design-system-cli-legacy"
+  },
+  "dependencies": {
+    "@contentful/experience-design-system-types": "workspace:*",
+    "@inkjs/ui": "^2.0.0",
+    "@segment/analytics-node": "^3.0.0",
+    "@vue/compiler-sfc": "^3.5.31",
+    "commander": "^13.1.0",
+    "contentful-management": "^12.17.0",
+    "figures": "6.1.0",
+    "ink": "^5.2.1",
+    "react": "^18.3.1",
+    "react-devtools-core": "^4.19.1",
+    "svelte": "^5.56.4",
+    "ts-morph": "^27.0.2",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@contentful/experience-design-system-client": "workspace:*",
+    "@contentful/experience-design-system-extraction": "workspace:*",
+    "@contentful/experience-design-system-generation": "workspace:*",
+    "@tsconfig/node24": "^24.0.4",
+    "@types/node": "^24.0.3",
+    "@types/react": "^18.3.24",
+    "eslint": "^9.39.5",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.6",
+    "ink-testing-library": "^4.0.0",
+    "typescript-eslint": "^8.67.0",
+    "vitest": "^4.0.16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/contentful/experience-design-system-sdk-public.git",
+    "directory": "packages/experience-design-system-cli-legacy"
+  },
+  "homepage": "https://github.com/contentful/experience-design-system-sdk-public#readme",
+  "bugs": {
+    "url": "https://github.com/contentful/experience-design-system-sdk-public/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}

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

@@ -0,0 +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).
+ */
+export type EdgeProvenance = 'typed-slot' | 'structural' | 'manifest' | 'doc' | `adapter:${string}` | 'agent';
+export type CompositionEdge = {
+    parent: string;
+    child: string;
+    /** Optional named slot (T7). Default slot when omitted. */
+    slot?: string;
+    /** 1–5 scale, same as select/reject agent tools. */
+    confidence?: number;
+    provenance: EdgeProvenance;
+};

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

@@ -0,0 +1,10 @@
+export type CompositionCliOptions = {
+    /** `--composition-refresh` — force edge emission to run even over resolved residue. */
+    compositionRefresh?: boolean;
+    /** `--no-cache` — force the composition agent to rerun with the rest of the pipeline. */
+    noCache?: boolean;
+};
+export type ResolvedCompositionSources = {
+    forceAgent: boolean;
+};
+export declare function resolveCompositionSources(opts: CompositionCliOptions): ResolvedCompositionSources;

package/{dist → legacy/dist}/src/analyze/composition/resolve-mapping.d.ts

@@ -1,9 +1,8 @@
 import type { RawComponentDefinition } from '../../types.js';
-import { type CompositionEdge, type InterchangeMap } from './interchange-schema.js';
+import type { CompositionEdge } from './interchange-schema.js';
 import { type EdgeConflict } from './merge-edges.js';
 export type ResolveMappingResult = {
     components: RawComponentDefinition[];
-    userMap?: InterchangeMap;
     edges: CompositionEdge[];
     conflicts: EdgeConflict[];
     warnings: string[];
@@ -11,9 +10,9 @@ export type ResolveMappingResult = {
 /**
  * Orchestrate composition-edge acquisition and enrichment.
  *
- * 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
+ * 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
  * 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
@@ -28,7 +27,6 @@ export type ResolveMappingResult = {
  */
 export declare function resolveMapping(input: {
     components: RawComponentDefinition[];
-    userMap?: InterchangeMap;
     forceAgent?: boolean;
     files: Array<{
         path: string;
@@ -55,7 +53,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 the user map.
+     * code slots and other automatic mapping sources.
      */
     extraEdges?: CompositionEdge[];
 }): Promise<ResolveMappingResult>;

package/{dist → legacy/dist}/src/analyze/extract-command.d.ts

@@ -1,3 +1,7 @@
 import type { Command } from 'commander';
+export declare function resolveExtractNoCache(opts: {
+    cache?: boolean;
+    noCache?: boolean;
+}): boolean;
 export declare function collectSourceFiles(directory: string, onProgress?: (scannedCount: number) => void): Promise<string[]>;
 export declare function registerInternalExtractCommand(program: Command): void;

package/{dist → legacy/dist}/src/analyze/select/tui/components/FieldEditor.d.ts

@@ -17,6 +17,7 @@ export type FieldEditorProps = {
     value: string;
     width: number;
     height: number;
+    fixedHeight?: boolean;
     active?: boolean;
     onChange: (value: string) => void;
     onSave: () => void;
@@ -40,6 +41,7 @@ export type FieldEditorProps = {
         name: string;
     };
     showHiddenProps?: boolean;
+    showInlineRationales?: boolean;
 };
 export declare function simulateGraphWithCandidate(projectSlotGraph: ComponentSlotInfo[], selfName: string, currentSlots: {
     name: string;
@@ -58,5 +60,5 @@ export declare function computeAllowedComponentReplacementCandidates(projectSlot
     name: string;
     allowedComponents: string[];
 }[], targetSlotName: string, replaceIndex: number): string[];
-export declare function FieldEditor({ value, width, height, active, onChange, onSave, onDiscard, onExit, metadata, onTogglePropRationale, propRationaleKey, onToggleComponentRationale, componentRationaleKey, onToggleSourceExternal, onTextEntryActiveChange, projectSlotGraph, currentComponentName, onDirtyChange, discardTrigger, initialFocusTarget, showHiddenProps, }: FieldEditorProps): React.ReactElement;
+export declare function FieldEditor({ value, width, height, fixedHeight, active, onChange, onSave, onDiscard, onExit, metadata, onTogglePropRationale, propRationaleKey, onToggleComponentRationale, componentRationaleKey, onToggleSourceExternal, onTextEntryActiveChange, projectSlotGraph, currentComponentName, onDirtyChange, discardTrigger, initialFocusTarget, showHiddenProps, showInlineRationales, }: FieldEditorProps): React.ReactElement;
 export {};

package/{dist → legacy/dist}/src/analyze/select/tui/components/FinalizeDialog.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { ComponentTypeSummary } from '@contentful/experience-design-system-types';
-/** Max removed-component lines shown at once; the rest scroll with j/k.
+/** Max removed-component lines shown at once; the rest scroll with arrow keys.
  *  Exported so the parent's scroll-offset clamping stays in sync. */
 export declare const FINALIZE_REMOVED_WINDOW = 6;
 type FinalizeDialogProps = {
@@ -15,7 +15,7 @@ type FinalizeDialogProps = {
     /** Status of the accepted-set preview fired when the dialog opened. While
      *  'running', the deletion section shows a spinner instead of a (stale) list. */
     previewStatus?: 'idle' | 'running' | 'done' | 'error';
-    /** Scroll offset into the removed list (owned by the parent; j/k adjust it). */
+    /** Scroll offset into the removed list (owned by the parent; arrow keys adjust it). */
     removedScrollOffset?: number;
 };
 export declare function FinalizeDialog({ accepted, rejected, needsReview, onConfirm, onCancel, removed, previewStatus, removedScrollOffset, }: FinalizeDialogProps): React.ReactElement;

package/{dist → legacy/dist}/src/analyze/select/tui/components/GroupedSidebar.d.ts

@@ -17,6 +17,9 @@ export interface GroupedSidebarProps {
     expandedGroups: Set<string>;
     onToggleExpanded: (rootName: string) => void;
     width: number;
+    height?: number;
+    title?: string;
+    wrapLabels?: boolean;
     focused: boolean;
     renderStatusByKey?: Map<string, RenderStatus>;
     previewAnnotationByKey?: Map<string, PreviewAnnotation>;

package/{dist → legacy/dist}/src/analyze/select/tui/components/HelpOverlay.d.ts

@@ -10,10 +10,12 @@ type HelpOverlayProps = {
     mode: 'analyze' | 'validate' | 'review';
     sections?: undefined;
     onClose: () => void;
+    handleInput?: boolean;
 } | {
     mode?: undefined;
     sections: HelpSection[];
     onClose: () => void;
+    handleInput?: boolean;
 };
 export declare function HelpOverlay(props: HelpOverlayProps): React.ReactElement;
 export {};

package/{dist → legacy/dist}/src/analyze/select/tui/components/Sidebar.d.ts

@@ -7,8 +7,9 @@ export type PreviewBadgeValue = {
     bold?: boolean;
     dim?: boolean;
 };
-export declare function PreviewBadge({ badge }: {
+export declare function PreviewBadge({ badge, highlighted, }: {
     badge: PreviewBadgeValue | null;
+    highlighted?: boolean;
 }): React.ReactElement;
 type SidebarProps = {
     components: ReviewComponentSummary[];

package/{dist → legacy/dist}/src/analyze/select/tui/hooks/scroll-offset.d.ts

@@ -8,15 +8,16 @@
  * binding (caller should NOT update state in that case).
  *
  * Supported bindings:
- * - j / downArrow      → +1 line
- * - k / upArrow        → -1 line
+ * - downArrow          → +1 line
+ * - upArrow            → -1 line
  * - Ctrl+d             → +half-page (floor(panelHeight / 2))
  * - Ctrl+u             → -half-page
  * - PageDown           → +panelHeight
  * - PageUp             → -panelHeight
  * - G                  → jump to maxOffset
  *
- * `g` (single-tap) and `gg` (double-tap → jump to 0) are handled separately
+ * `j`/`k` are intentionally not handled here because they are field-navigation
+ * keys in the editor. `g` (single-tap) and `gg` (double-tap → jump to 0) are handled separately
  * by the caller via a pending-flag ref, since they need transient state.
  */
 export type ScrollKeyState = {

package/{dist → legacy/dist}/src/analyze/select/tui/hooks/useImmediateInput.d.ts

@@ -16,4 +16,4 @@ export type ImmediateInputKey = {
     meta: boolean;
 };
 export type ImmediateInputHandler = (input: string, key: ImmediateInputKey) => void;
-export declare function useImmediateInput(handler: ImmediateInputHandler): void;
+export declare function useImmediateInput(handler: ImmediateInputHandler, enabled?: boolean): void;

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

@@ -0,0 +1,18 @@
+export type ExperiencesCredentials = {
+    spaceId: string;
+    environmentId: string;
+    cmaToken: string;
+    host?: string;
+    agent?: string;
+    agentModel?: string;
+    /** Feature 8: persisted custom prompt path for `generate components`. */
+    generatePromptPath?: string;
+    /** Write JSONL trace of every command decision to ~/.contentful/experience-design-system-cli/debug/. */
+    debug?: boolean;
+    /** Print plain text with no color; an exported NO_COLOR still wins. */
+    noColor?: boolean;
+    analyticsDisabled?: boolean;
+};
+export declare function readExperiencesCredentials(): Promise<ExperiencesCredentials>;
+export declare function writeExperiencesCredentials(creds: ExperiencesCredentials): Promise<void>;
+export declare function experiencesCredentialsPath(): string;

package/legacy/dist/src/doctor/checks.d.ts

@@ -0,0 +1,5 @@
+export declare function reportNode(): Promise<boolean>;
+export declare function reportPnpm(pkgRoot: string): Promise<boolean>;
+export declare function reportDependencies(pkgRoot: string): Promise<boolean>;
+export declare function reportBuild(pkgRoot: string): Promise<boolean>;
+export declare function reportAgent(): Promise<boolean>;

package/legacy/dist/src/doctor/command.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerDoctorCommand(program: Command): void;

package/legacy/dist/src/doctor/report.d.ts

@@ -0,0 +1,7 @@
+export declare function ok(msg: string): void;
+export declare function fail(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function info(msg: string): void;
+export declare function section(title: string): void;
+/** Echo the first `limit` lines of a failed command's stderr. */
+export declare function infoStderr(stderr: string, limit: number): void;