@contentful/experience-design-system-cli 2.37.1-dev-build-a2aef8c6.0 → 2.37.1-dev-build-a67bc4a4.0

package/dist/package.json

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

package/dist/src/tui/settings/{configuration/ConfigurationScreen.d.ts → contentful-configuration/ContentfulConfigScreen.d.ts}

@@ -1,5 +1,4 @@
 import React from 'react';
-/** Settings > Configuration: a short menu that opens the Project settings or the Agent settings. */
 export declare function ConfigurationScreen({ onDone }: {
     onDone: () => void;
 }): React.ReactElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-a2aef8c6.0",
+  "version": "2.37.1-dev-build-a67bc4a4.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-a2aef8c6.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-a2aef8c6.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-a67bc4a4.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-a67bc4a4.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/dist/src/tui/help/file-locations.d.ts

@@ -1,23 +0,0 @@
-export interface FileLocationInput {
-    /** The Root Project Directory from Settings > Configuration > Project. Empty when not set. */
-    contentfulBaseDir: string;
-    /** Whether Debug Mode is on. Debug logs and the per-run folders only exist while it is. */
-    debugModeEnabled: boolean;
-    /** This terminal session's folder, once it has started. */
-    currentSessionDir: string | undefined;
-}
-export interface FileLocations {
-    debugLogs: string;
-    importFiles: string;
-}
-/**
- * Where the CLI writes the files a user goes looking for, from the settings that decide it (see `startImportRun`).
- *
- * With Debug Mode on, everything goes in this terminal session's folder, `<base>/.contentful/<date>-session-N/`:
- * the debug logs in `debug/` and, for each import, a `dsi-import-N/` folder with `tokens.json` and `components.json`.
- * `<base>` is the Root Project Directory, or the project being imported when none is set. With Debug Mode off there is
- * no session folder and no logs, and the files go to `<project>/.contentful/`.
- *
- * Names that are only known when a session or an import starts are shown as patterns, never guessed.
- */
-export declare function describeFileLocations({ contentfulBaseDir, debugModeEnabled, currentSessionDir, }: FileLocationInput): FileLocations;

package/dist/src/tui/settings/configuration/agents/AgentDetail.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
-import { type AgentConfig } from './agent-store.js';
-/**
- * One agent's screen: what was found for it, its two settings, and the test. Saving writes the whole agent config, so the
- * default agent and the other agents are kept. The test uses the values on screen, saved or not.
- */
-export declare function AgentDetail({ name, config, setConfig, onBack, }: {
-    name: AgentName;
-    config: AgentConfig;
-    setConfig: (config: AgentConfig) => void;
-    onBack: () => void;
-}): React.ReactElement;

package/dist/src/tui/settings/configuration/agents/AgentStatusBadge.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-import type { AgentName } from '@contentful/experience-design-system-backend-pipeline';
-import { type AgentCheck, type StatusRow } from './agent-status.js';
-export declare const TONE_COLOR: Record<StatusRow['tone'], string>;
-/** The symbol and one-word state for an agent, shown on its row in the list. `binary` is the saved path, empty when none is saved. */
-export declare function AgentStatusBadge({ name, checks, binary, }: {
-    name: AgentName;
-    checks: AgentCheck[] | undefined;
-    binary: string;
-}): React.ReactElement;

package/dist/src/tui/settings/configuration/agents/AgentsScreen.d.ts

@@ -1,11 +0,0 @@
-import React from 'react';
-/**
- * Settings > Configuration > Agents. The list holds only what is needed to pick an agent: the name, a star on the default,
- * and a one-word status. Below it, a panel shows the full detail for the focused agent and follows the cursor, so nothing
- * has to be opened to read it. The "Default agent" line at the top is read-only: ↑/↓ move through the agents, Enter makes
- * the focused one the default (saved at once), and → opens its own screen, where its path and model are edited and the
- * test is run.
- */
-export declare function AgentsScreen({ onDone }: {
-    onDone: () => void;
-}): React.ReactElement;

package/dist/src/tui/settings/configuration/agents/agent-status.d.ts

@@ -1,63 +0,0 @@
-import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
-type AgentCheckStep = 'path' | 'version' | 'login' | 'prompt';
-export type AgentCheck = {
-    step: AgentCheckStep;
-    ok: boolean;
-    /** One line for the user: the version string, the reason it failed, or what to run next. */
-    detail: string;
-    /** Only on the prompt step: the agent did not answer in time. That is not the same as a failure or a missing login. */
-    timedOut?: boolean;
-};
-/**
- * The one-word state shown on an agent's row. `not-configured` means no path is saved and the command is not on the
- * PATH; `not-found` means a saved path does not work. `unknown` means it runs but its login cannot be checked.
- */
-export type AgentStatus = 'checking' | 'ready' | 'not-configured' | 'not-found' | 'not-logged-in' | 'test-failed' | 'timed-out' | 'unknown';
-/** The model the agent runs with when none is saved ("haiku", "gpt-mini", or the agent's own pick), for the model row. */
-export declare function defaultModelLabel(name: AgentName): string;
-/**
- * Steps 1 to 3 against `binary`. Never throws and never spends tokens, so it is safe to run for every row on open.
- * Checks the path the user typed, not what is saved, so the form can test a value before it is written.
- */
-export declare function inspectAgent(name: AgentName, binary: string): Promise<AgentCheck[]>;
-/** Steps 1 to 4. The prompt step is the only way to verify login and model name for agents other than claude. */
-export declare function testAgent(name: AgentName, binary: string, model: string): Promise<AgentCheck[]>;
-/** Collapses a list of checks into the status shown on the row. */
-export declare function statusFromChecks(name: AgentName, checks: readonly AgentCheck[], savedBinary: string): AgentStatus;
-export type StatusRow = {
-    label: string;
-    value: string;
-    tone: 'ok' | 'bad' | 'muted';
-};
-/**
- * How a full test went, in one line for a banner on the agent's screen. Undefined when no test has run (the quick checks
- * alone are not a test), so the banner only appears after the user asked for one.
- */
-export declare function testOutcome(checks: readonly AgentCheck[] | undefined): {
-    ok: boolean;
-    text: string;
-} | undefined;
-/**
- * The short form of a status for the list, where every row has to be scannable at a glance. The wording is plainer than
- * the detail panel's: "not installed" covers both "nothing saved" and "saved path broken", which the panel tells apart.
- */
-export declare const LIST_STATUS: Record<AgentStatus, {
-    symbol: string;
-    text: string;
-    tone: StatusRow['tone'];
-}>;
-/**
- * The rows of the detail panel under the list, for the focused agent. Everything here is read-only and comes from
- * checks already collected, so moving the cursor never runs anything.
- */
-export declare function panelRows(name: AgentName, checks: readonly AgentCheck[] | undefined, settings: {
-    binary: string;
-    model: string;
-}): StatusRow[];
-/**
- * What the Status section of an agent's screen shows: the shared rows, then the login and the test, which only this
- * view has. The login row is always there once the command is found, because for most agents it has to say that login
- * cannot be checked without a test.
- */
-export declare function statusRows(name: AgentName, checks: readonly AgentCheck[] | undefined, savedBinary: string): StatusRow[];
-export {};

package/dist/src/tui/settings/configuration/agents/agent-store.d.ts

@@ -1,16 +0,0 @@
-import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
-export type AgentSettings = {
-    /** Passed as --model. Empty: the agent's built-in default (see defaultModelLabel). */
-    model: string;
-    /** Path to the agent's command. Empty: the command name is looked up on the PATH. */
-    binary: string;
-};
-export type AgentConfig = {
-    /** The agent the CLI uses when `--agent` is not given. */
-    defaultAgent: AgentName;
-    agents: Record<AgentName, AgentSettings>;
-};
-export declare const AGENT_LABELS: Record<AgentName, string>;
-export declare function emptyAgents(): Record<AgentName, AgentSettings>;
-export declare function readAgentConfig(): Promise<AgentConfig>;
-export declare function writeAgentConfig(config: AgentConfig): Promise<void>;

package/dist/src/tui/settings/configuration/agents/apply-binary-overrides.d.ts

@@ -1,13 +0,0 @@
-import type { AgentConfig } from './agent-store.js';
-/**
- * The pipeline picks an agent's binary from `EDS_AGENT_BINARY_<AGENT>` and nowhere else. This copies each saved
- * `agents.<name>.binary` into that variable, so the saved path reaches every place that spawns an agent (the import,
- * the generation package and the legacy commands) without touching their call sites.
- *
- * Called once at startup, and again after Settings saves a binary so a change applies without a restart.
- *
- * Settings wins over a variable already in the shell, so a forgotten `EDS_AGENT_BINARY_CLAUDE` cannot silently override
- * what the user sees on screen. An agent with no saved path leaves the shell's variable alone, and clearing a path
- * puts the shell's value back.
- */
-export declare function applyBinaryOverrides(config: AgentConfig): void;

package/dist/src/tui/settings/configuration/project/ProjectScreen.d.ts

@@ -1,5 +0,0 @@
-import React from 'react';
-/** The Contentful project settings: the space, credentials, defaults and where `.contentful` goes. */
-export declare function ProjectScreen({ onDone }: {
-    onDone: () => void;
-}): React.ReactElement;

package/dist/src/tui/settings/shared/FieldForm.d.ts

@@ -1,50 +0,0 @@
-import React from 'react';
-export interface FormField<K extends string> {
-    key: K;
-    label: string;
-    /** A short note shown dimmed after the value, so the label column stays narrow. */
-    hint?: string;
-    /** Shows dots instead of the value, for secrets. */
-    masked?: boolean;
-}
-/** A row after the fields that Enter runs instead of opening for editing, such as "Run test". */
-export interface FormAction {
-    label: string;
-    /** What running it does, shown dimmed after the label. */
-    description: string;
-    /** Shown instead of the description while it runs. */
-    runningText?: string;
-    running?: boolean;
-    /** The control hint for Enter while this row is focused. */
-    hint: string;
-    onRun: () => void;
-}
-export type FormNotice = {
-    kind: 'success' | 'error';
-    text: string;
-};
-interface FieldFormProps<K extends string> {
-    title: string;
-    /** What this form is for, shown dimmed under the title. */
-    subtitle?: string;
-    fields: readonly FormField<K>[];
-    values: Record<K, string>;
-    onChange: (key: K, value: string) => void;
-    onSave: () => void;
-    /** Leaves without saving. */
-    onQuit: () => void;
-    /** Rows after the fields that are run, not edited. They share the cursor with the fields. */
-    actions?: readonly FormAction[];
-    notice?: FormNotice | null;
-    /** Ignores keys while a load or save is in flight. */
-    busy?: boolean;
-    /** Shown after the rows and the notice, for read-only content that belongs to the same screen. */
-    children?: React.ReactNode;
-}
-/**
- * The edit-in-place form the Configuration pages share. Fields are read-only until Enter opens one; Enter again closes it.
- * While one is open, keys type into it (so a "q" in a path is just a "q"), and Esc closes it and restores the old value.
- * Actions sit after the fields and take the same cursor: Enter runs one, and `c` does nothing on it.
- */
-export declare function FieldForm<K extends string>({ title, subtitle, fields, values, onChange, onSave, onQuit, actions, notice, busy, children, }: FieldFormProps<K>): React.ReactElement;
-export {};

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

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