@contentful/experience-design-system-cli 2.37.1-dev-build-91ca3bb8.0 → 2.37.1-dev-build-a7704a7f.0

package/dist/package.json

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

package/dist/src/tui/settings/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-91ca3bb8.0",
+  "version": "2.37.1-dev-build-a7704a7f.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-91ca3bb8.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-91ca3bb8.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-a7704a7f.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-a7704a7f.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/dist/src/commands/forwarded.d.ts

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

package/dist/src/legacy/forwarded-import-args.d.ts

@@ -1 +0,0 @@
-export declare function forwardedImportArgs(argv: string[]): string[];

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

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

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

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

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/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/agents/AgentScreens.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/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/agents/agent-status.d.ts

@@ -1,80 +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 binary the import will actually run for this agent: the saved path if there is one, otherwise the built-in
- * command name. Shown in the form so the user sees what is used when the field is empty.
- */
-export declare function effectiveBinary(name: AgentName, savedBinary: string): string;
-/** 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;
-/**
- * What to tell a user whose agent is not ready: the install command, or the login command. Empty when nothing is needed.
- * Shown on the list's panel and on the agent's own screen, so it cannot say where the command path is ("below"): it
- * names the settings instead, which is the same place from both.
- */
-export declare function setupHint(name: AgentName, status: AgentStatus): string;
-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 model line for the detail panel: what is saved, or what the agent really runs with when nothing is. Says which of
- * the two it is, so a user can tell their own choice from the built-in default.
- */
-export declare function modelLine(name: AgentName, savedModel: string): string;
-/**
- * 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[];
-/** The resolved path of the command, when the checks found it. For the list, where the user wants to see what runs. */
-export declare function resolvedPath(checks: readonly AgentCheck[] | undefined): string;
-/**
- * What the Status section of an agent's screen shows, one row per thing that was checked. 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/agents/agent-store.d.ts

@@ -1,17 +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 const AGENT_HINTS: 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/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/contentful-configuration/ProjectConfigScreen.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 ProjectConfigScreen({ onDone }: {
-    onDone: () => void;
-}): React.ReactElement;

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

@@ -1,35 +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;
-}
-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;
-    notice?: FormNotice | null;
-    /** Ignores keys while a load or save is in flight. */
-    busy?: boolean;
-    /** Shown above the controls, for a screen's own explanation. */
-    footer?: 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.
- */
-export declare function FieldForm<K extends string>({ title, subtitle, fields, values, onChange, onSave, onQuit, notice, busy, footer, }: FieldFormProps<K>): React.ReactElement;
-export {};

package/legacy/bin/cli.js

@@ -1,58 +0,0 @@
-#!/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

@@ -1,76 +0,0 @@
-{
-  "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-backend-pipeline": "workspace:*",
-    "@contentful/experience-design-system-types": "workspace:*",
-    "@inkjs/ui": "^2.0.0",
-    "@segment/analytics-node": "^3.0.0",
-    "@vue/compiler-sfc": "^3.5.31",
-    "ajv": "^8.17.1",
-    "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",
-    "zod": "^4.3.6"
-  },
-  "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/analytics/exit.d.ts

@@ -1,4 +0,0 @@
-import { type CommandFailure } from '@contentful/experience-design-system-backend-pipeline';
-import type { ApiError } from '../apply/api-client.js';
-export declare function exitWithAnalytics(code: number, fields?: CommandFailure): Promise<never>;
-export declare function failureFromApiError(error: ApiError): CommandFailure;

package/legacy/dist/src/analytics/index.d.ts

@@ -1,3 +0,0 @@
-export { bindAnalyticsSessionId, completeActiveCommand, emitSessionStarted, enrichCommandResult, failActiveCommand, flushAnalytics, isPipelineAnalyticsChild, noteCommandStart, recordApplyOutcome, recordContentfulContext, setCliVersion, setPersistedAnalyticsDisabled, } from '@contentful/experience-design-system-backend-pipeline';
-export type { CommandFailure } from '@contentful/experience-design-system-backend-pipeline';
-export { exitWithAnalytics, failureFromApiError } from './exit.js';

package/legacy/dist/src/analyze/composite-closure.d.ts

@@ -1,26 +0,0 @@
-export interface ComponentGraphNode {
-    name: string;
-    slots: Array<{
-        name: string;
-        allowedComponents?: string[];
-    }>;
-}
-interface ClosureNode {
-    name: string;
-    depth: number;
-    path: string[];
-    parents: string[];
-}
-export interface Closure {
-    root: string;
-    nodes: ClosureNode[];
-    containsCycle: boolean;
-    cyclePath?: string[];
-}
-export type NodeStatus = 'ok' | 'warning' | 'error';
-export declare function findRoots(components: ComponentGraphNode[], selected?: Set<string>): string[];
-export declare function computeClosure(root: string, components: ComponentGraphNode[]): Closure;
-export declare function computeAllClosures(components: ComponentGraphNode[], selected?: Set<string>): Map<string, Closure>;
-export declare function aggregateStatus(closure: Closure, perNodeStatus: Map<string, NodeStatus>): NodeStatus;
-export declare function findSharedDeps(closures: Map<string, Closure>): Map<string, string[]>;
-export {};

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

@@ -1,22 +0,0 @@
-import type { RawComponentDefinition } from '../../types.js';
-import type { CompositionEdge } from './interchange-schema.js';
-export type ApplyMappingResult = {
-    components: RawComponentDefinition[];
-    warnings: string[];
-};
-/**
- * Enrichment pass (spec T7): merge a resolved composition edge list into the
- * extracted components' `allowedComponents`. Runs AFTER extraction; it is the
- * mapping resolver's entire job — populating the one field every downstream
- * graph consumer reads.
- *
- * Slot targeting:
- *  - edge.slot present + slot exists → write there.
- *  - edge.slot present + slot missing → synthesize for high-trust
- *    (typed-slot / adapter) edges; drop-and-warn for `agent` edges.
- *  - edge.slot absent → default slot (isDefault), synthesized if none exists.
- *
- * Edges naming unknown parents/children are dropped-and-warned (§1.3). Inputs
- * are not mutated; a deep-enough clone of touched slots is returned.
- */
-export declare function applyMapping(components: RawComponentDefinition[], edges: CompositionEdge[]): ApplyMappingResult;

package/legacy/dist/src/analyze/composition/candidate-files.d.ts

@@ -1,34 +0,0 @@
-export declare const CANDIDATE_NAME_PATTERNS: RegExp[];
-export declare const CANDIDATE_CONTENT_MARKERS: string[];
-export declare const CANDIDATE_TOKEN_BUDGET = 6000;
-/**
- * Token ceiling for the candidate set INLINED into a single agent prompt.
- * Sized to stay under a 200k-context model once the agent's own system prompt
- * + tool definitions (~105k observed) are added, so a large design system
- * (hundreds of components → many matched files) can't overflow the request and
- * fail resolution. Files beyond the budget are dropped (with a warning), not
- * silently truncated. Distinct from `CANDIDATE_TOKEN_BUDGET`, which sizes the
- * unused per-batch chunking.
- */
-export declare const PROMPT_CANDIDATE_TOKEN_BUDGET = 80000;
-export type CandidateFile = {
-    path: string;
-    content: string;
-};
-export type SelectedCandidate = CandidateFile & {
-    reason: string;
-};
-export declare function selectCandidateFiles(files: CandidateFile[]): SelectedCandidate[];
-/**
- * Cap a candidate set to what fits in a single agent prompt (see
- * `PROMPT_CANDIDATE_TOKEN_BUDGET`). Files are kept smallest-first so the budget
- * admits the most declarations; deterministic tie-break by path. Returns the
- * kept files plus the paths dropped so the caller can warn (silent truncation
- * would read as "resolved everything" when it didn't).
- */
-export declare function capCandidatesToPromptBudget<T extends CandidateFile>(files: T[], budget?: number): {
-    kept: T[];
-    dropped: T[];
-};
-export declare function sliceDeclarationRegions(content: string, markers?: string[], window?: number): string[];
-export declare function batchCandidates(files: CandidateFile[], budget?: number): CandidateFile[][];

package/legacy/dist/src/analyze/composition/composition-cache-key.d.ts

@@ -1,18 +0,0 @@
-/**
- * Derive the `input_hash` for a composition-cache entry (stored in the pipeline
- * DB's `composition_cache` table). Content-addresses the candidate file set
- * (order-independent) plus the producing agent, so a re-run over unchanged
- * files reuses the (token-costly) agent output.
- *
- * Content-hashing — not mtime — means a no-op `git checkout` that only bumps
- * mtime is still a hit. Prompt/skill changes are handled by the `cli_version`
- * column on the row (see `getCliCacheVersion`), so no separate resolver-version
- * constant is needed here.
- */
-export declare function buildCompositionInputHash(input: {
-    files: Array<{
-        path: string;
-        content: string;
-    }>;
-    agent: string;
-}): string;

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

@@ -1,17 +0,0 @@
-/**
- * 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/manifest-doc-evidence.d.ts

@@ -1,49 +0,0 @@
-import type { CompositionEdge } from './interchange-schema.js';
-type CandidateFile = {
-    path: string;
-    content: string;
-};
-type ComponentRef = {
-    name: string;
-    sourcePath?: string;
-};
-/**
- * Prompt-injection safeguard for this signal: both parsers below are plain
- * deterministic code, never an LLM prompt. `manifest.json`/`AGENTS.md`
- * content is attacker-adjacent (Figma-authored / free-form prose respectively)
- * but it only ever flows through JSON field access and a fixed regex, then is
- * validated against the real `componentNames` allowlist before an edge is
- * emitted — there is no path from this file's content to model instructions.
- */
-/** Figma/manifest names are kebab-case (`blue-accordion-item`); React exports are PascalCase. */
-export declare function kebabToPascal(name: string): string;
-/**
- * Deterministic parse of a Figma-exported `manifest.json` — no LLM involved.
- * Schema (confirmed against a real design-system manifest):
- *   { component: { name: "blue-accordion" },
- *     variantsMeta: { componentPropertyDefinitions: {
- *       "Slot#1533:33": { type: "SLOT", preferredValues: [{ name: "blue-accordion-item" }] }
- *     } } }
- * The manifest's own `component.name` identifies its owning/parent component
- * (more robust than inferring from directory proximity, since manifest.json
- * typically lives one level below the component's source file, e.g. in a
- * sibling `design/` directory).
- */
-export declare function collectManifestEdges(files: CandidateFile[], componentNames: ReadonlySet<string>): CompositionEdge[];
-/**
- * Deterministic parse of a component-level `AGENTS.md` — no LLM involved.
- * Only a bold-backtick component mention (`` **`ComponentName`** ``) on a
- * line that ALSO carries a composition keyword is accepted, e.g. "Direct
- * **`AccordionItem`** children only." A bare cross-reference mention (no
- * composition keyword on the same line, e.g. "see `other-component`") is
- * rejected — it isn't asserting a parent-child relationship.
- *
- * The doc's owning component is resolved by directory colocation: the
- * component whose `sourcePath` sits in the same directory as the doc file
- * (the real-world convention — `<component>/AGENTS.md` next to
- * `<component>/Component.tsx`).
- */
-export declare function collectAgentsDocEdges(files: CandidateFile[], components: ComponentRef[], componentNames: ReadonlySet<string>): CompositionEdge[];
-/** Both deterministic sources, combined for the `extraEdges` wiring in command.ts. */
-export declare function collectManifestDocEdges(files: CandidateFile[], components: ComponentRef[], componentNames: ReadonlySet<string>): CompositionEdge[];
-export {};

package/legacy/dist/src/analyze/composition/merge-edges.d.ts

@@ -1,19 +0,0 @@
-import type { CompositionEdge, EdgeProvenance } from './interchange-schema.js';
-export type EdgeConflict = {
-    parent: string;
-    child: string;
-    winner: EdgeProvenance;
-    loser: EdgeProvenance;
-};
-export type MergeResult = {
-    edges: CompositionEdge[];
-    conflicts: EdgeConflict[];
-};
-/**
- * Union all edges, resolving conflicts by provenance rank. A conflict is two
- * edges that share `parent::child` but disagree on existence-detail (here:
- * slot placement). The higher-ranked edge wins; the loser is recorded (never
- * silently dropped) so the review UI can surface it. Identical edges (same
- * parent/child/slot) collapse to the highest-ranked copy with no conflict.
- */
-export declare function mergeEdges(all: CompositionEdge[]): MergeResult;

package/legacy/dist/src/analyze/composition/parse-map-edges.d.ts

@@ -1,16 +0,0 @@
-import type { CompositionEdge } from './interchange-schema.js';
-/**
- * Lenient JSONL parser for the composition-mapping agent's tool-call output
- * (spec T4). Mirrors `parseSelectToolCallLines` / `parseToolCallLines` in
- * `@contentful/experience-design-system-generation`'s `agent-runner.ts`: one JSON object per line, each with a `tool`
- * field from a fixed allowlist. A line that fails JSON.parse or validation is
- * DROPPED into `warnings[]` (with a reason) and parsing CONTINUES — no retry,
- * no throw. Non-`{` prose and blank lines are skipped silently.
- */
-export type ParseMapEdgesResult = {
-    edges: CompositionEdge[];
-    warnings: string[];
-};
-export declare function parseMapEdges(raw: string, opts: {
-    componentNames: Set<string>;
-}): ParseMapEdgesResult;

package/legacy/dist/src/analyze/composition/prompt-loader.d.ts

@@ -1,3 +0,0 @@
-/** Resolve a bundled composition prompt from the package-root prompts directory. */
-export declare function resolvePromptPath(fileName: string): string;
-export declare function loadPrompt(fileName: string): string;

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

@@ -1,10 +0,0 @@
-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;