@contentful/experience-design-system-cli 2.38.0 → 2.38.1-dev-build-6d903339.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.38.0",
+  "version": "2.38.1-dev-build-6d903339.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,8 @@
   "files": [
     "bin/",
     "dist/",
-    "legacy/"
+    "legacy/",
+    "skills/"
   ],
   "scripts": {
     "build": "nx build experience-design-system-cli",
@@ -37,10 +38,12 @@
     "dev": "node scripts/dev.mjs"
   },
   "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.18.0",
     "commander": "^13.1.0",
     "contentful-management": "^12.17.0",
     "figures": "6.1.0",
@@ -51,7 +54,8 @@
     "semver": "^7.7.2",
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -62,6 +66,7 @@
     "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/src/commands/import-options.d.ts

@@ -0,0 +1,12 @@
+export interface ImportOptions {
+    agent?: string;
+    prompt: string[];
+    cache: boolean;
+}
+interface RawImportOptions {
+    agent?: string;
+    prompt?: string[];
+    cache?: boolean;
+}
+export declare function toImportOptions(raw: RawImportOptions): ImportOptions;
+export {};

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

@@ -1,2 +1,3 @@
 import type { Command } from 'commander';
-export declare function registerImportCommand(program: Command, openTui: () => Promise<void>): void;
+import { type ImportOptions } from './import-options.js';
+export declare function registerImportCommand(program: Command, openTui: (options: ImportOptions) => Promise<void>): void;

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

@@ -1,10 +1,9 @@
 export declare const PALETTE: {
     readonly accent: "#1773EB";
-    readonly heading: "#FFFFFF";
     readonly success: "#00C459";
     readonly error: "#E44F20";
     readonly warning: "#FFDA00";
-    readonly muted: "#A6B5C7";
+    readonly muted: "#8B8D91";
     readonly border: "#C4D1DE";
 };
 export declare function brandBar(width: number, ramp?: readonly string[]): {

package/dist/src/tui/import/resolve-user-path.d.ts

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

package/dist/src/tui/import/shared/error-step/controls.d.ts

@@ -0,0 +1,7 @@
+interface ErrorHandlers {
+    onExit: () => void;
+    onRetry?: () => void;
+    onAcknowledge?: () => void;
+}
+export declare function useErrorControls(handlers: ErrorHandlers): void;
+export {};

package/{legacy/dist/src/import/tui/steps/ErrorStep.d.ts → dist/src/tui/import/shared/error-step/error-step.d.ts}

@@ -1,10 +1,10 @@
 import React from 'react';
-type ErrorStepProps = {
+interface ErrorStepProps {
     stepName: string;
     message: string;
     onExit: () => void;
     onRetryCredentials?: () => void;
     onAcknowledgeBreakingChanges?: () => void;
-};
+}
 export declare function ErrorStep({ stepName, message, onExit, onRetryCredentials, onAcknowledgeBreakingChanges, }: ErrorStepProps): React.ReactElement;
 export {};

package/dist/src/tui/import/shared/error-step/logic.d.ts

@@ -0,0 +1,15 @@
+interface Key {
+    return: boolean;
+    escape: boolean;
+}
+export type ErrorAction = 'exit' | 'retry' | 'acknowledge' | null;
+interface Available {
+    canRetry: boolean;
+    canAcknowledge: boolean;
+}
+export declare function errorAction(input: string, key: Key, available: Available): ErrorAction;
+export declare function errorControls(available: Available): {
+    keys: string;
+    label: string;
+}[];
+export {};

package/dist/src/tui/import/shared/gate-step/controls.d.ts

@@ -0,0 +1,8 @@
+interface GateHandlers {
+    canSkip: boolean;
+    onContinue: () => void;
+    onSkip: () => void;
+    onQuit: () => void;
+}
+export declare function useGateControls(handlers: GateHandlers): void;
+export {};

package/dist/src/tui/import/shared/gate-step/gate-step.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface GateStepProps {
+    message: string;
+    onContinue: () => void;
+    onQuit: () => void;
+    summary?: string;
+    context?: string;
+    continueLabel?: string;
+    skipLabel?: string;
+    onSkip?: () => void;
+    intent?: 'success' | 'error';
+}
+export declare function GateStep({ message, onContinue, onQuit, summary, context, continueLabel, skipLabel, onSkip, intent, }: GateStepProps): React.ReactElement;
+export {};

package/dist/src/tui/import/shared/gate-step/logic.d.ts

@@ -0,0 +1,11 @@
+interface Key {
+    return: boolean;
+    escape: boolean;
+}
+export type GateAction = 'continue' | 'skip' | 'quit' | null;
+export declare function gateAction(input: string, key: Key, canSkip: boolean): GateAction;
+export declare function gateControls(continueLabel: string, skipLabel: string, canSkip: boolean): {
+    keys: string;
+    label: string;
+}[];
+export {};

package/dist/src/tui/import/shared/index.d.ts

@@ -0,0 +1,3 @@
+export { ErrorStep } from './error-step/error-step.js';
+export { GateStep } from './gate-step/gate-step.js';
+export { RunningStep } from './running-step/running-step.js';

package/dist/src/tui/import/shared/running-step/logic.d.ts

@@ -0,0 +1,12 @@
+export interface Progress {
+    done: number;
+    total: number;
+}
+export interface RunningLine {
+    text: string;
+    complete?: boolean;
+    progress?: Progress;
+}
+export declare function progressPercent(progress: Progress): number;
+export declare function formatElapsed(totalSeconds: number): string;
+export declare function stepLabel(stepNumber: number, totalSteps: number, title: string): string;

package/dist/src/tui/import/shared/running-step/running-step.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { type RunningLine } from './logic.js';
+interface RunningStepProps {
+    stepNumber: number;
+    totalSteps: number;
+    title: string;
+    description: string;
+    lines?: readonly RunningLine[];
+}
+export declare function RunningStep({ stepNumber, totalSteps, title, description, lines, }: RunningStepProps): React.ReactElement;
+export {};

package/dist/src/tui/import/shared/running-step/theme.d.ts

@@ -0,0 +1,3 @@
+export declare const PROGRESS_THEME: {
+    components: Record<string, import("@inkjs/ui").ComponentTheme>;
+};

package/dist/src/tui/import/shared/running-step/use-elapsed.d.ts

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

package/dist/src/tui/import/steps/03-path-validation/controls.d.ts

@@ -0,0 +1,13 @@
+import { type PathPhase } from './logic.js';
+interface Control {
+    keys: string;
+    label: string;
+}
+interface PathValidationHandlers {
+    onConfirm: () => void;
+    onChangePath: () => void;
+    onBack: () => void;
+}
+export declare function controlsFor(phase: PathPhase): readonly Control[];
+export declare function usePathValidationControls(phase: PathPhase, handlers: PathValidationHandlers): void;
+export {};

package/dist/src/tui/import/steps/03-path-validation/helpers/scan-files.d.ts

@@ -0,0 +1,10 @@
+import { collectFiles } from '@contentful/experience-design-system-backend-pipeline';
+import type { FileCounts as LocalFileCounts, ScanResult } from '../logic.js';
+type CollectedFilesOutcome = ReturnType<typeof collectFiles>;
+type PipelineFileCounts = Extract<CollectedFilesOutcome, {
+    ok: true;
+}>['result']['counts'];
+export declare function scanFiles(directory: string): ScanResult;
+export declare function toScanResult(outcome: CollectedFilesOutcome): ScanResult;
+export declare function foldSvelteAndMdIntoOther(counts: PipelineFileCounts): LocalFileCounts;
+export {};

package/dist/src/tui/import/steps/03-path-validation/logic.d.ts

@@ -0,0 +1,43 @@
+type FileCategory = 'tsx' | 'ts' | 'vue' | 'astro' | 'jsx' | 'js' | 'json' | 'other';
+export type FileCounts = Record<FileCategory, number> & {
+    total: number;
+};
+export type ScanFailureCode = 'not-found' | 'permission-denied' | 'is-file' | 'not-directory' | 'unreadable';
+export type ScanResult = {
+    ok: true;
+    counts: FileCounts;
+    filePaths: string[];
+    warnings: string[];
+} | {
+    ok: false;
+    failure: ScanFailureCode;
+};
+export type PathPhase = 'scanning' | 'ready' | 'failed';
+export type KeyAction = 'confirm' | 'change-path' | 'back';
+export interface SummaryRow {
+    label: string;
+    count: number;
+    tone: 'default' | 'accent' | 'muted';
+}
+export interface Summary {
+    total: number;
+    rows: SummaryRow[];
+    warning?: string;
+}
+export interface FailureMessage {
+    headline: string;
+    hints: string[];
+}
+interface Key {
+    escape: boolean;
+    return: boolean;
+}
+export declare function emptyCounts(): FileCounts;
+export declare function addFile(counts: FileCounts, fileName: string): FileCounts;
+export declare function mergeCounts(a: FileCounts, b: FileCounts): FileCounts;
+export declare function failureFromErrorCode(code: string | undefined): ScanFailureCode;
+export declare function describeFailure(failure: ScanFailureCode, path: string): FailureMessage;
+export declare function summarize(counts: FileCounts): Summary;
+export declare function phaseOf(scan: ScanResult | undefined): PathPhase;
+export declare function keyAction(phase: PathPhase, input: string, key: Key): KeyAction | undefined;
+export {};

package/dist/src/tui/import/steps/03-path-validation/screen.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+interface PathValidationScreenProps {
+    projectPath: string;
+    onConfirm: (result: {
+        projectPath: string;
+        filePaths: string[];
+    }) => void;
+    onChangePath: () => void;
+    onBack: () => void;
+}
+export declare function PathValidationScreen({ projectPath, onConfirm, onChangePath, onBack, }: PathValidationScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/04-credentials/controls.d.ts

@@ -0,0 +1,21 @@
+export declare const CREDENTIALS_CONTROLS: readonly [{
+    readonly keys: "Enter";
+    readonly label: "Next field / Continue";
+}, {
+    readonly keys: "Tab";
+    readonly label: "Switch field";
+}, {
+    readonly keys: "Ctrl+S";
+    readonly label: "Skip (no push)";
+}, {
+    readonly keys: "Esc";
+    readonly label: "Back";
+}];
+interface CredentialsHandlers {
+    disabled: boolean;
+    onBack: () => void;
+    onNextField: () => void;
+    onSkip: () => void;
+}
+export declare function useCredentialsControls(handlers: CredentialsHandlers): void;
+export {};

package/dist/src/tui/import/steps/04-credentials/logic.d.ts

@@ -0,0 +1,15 @@
+export declare const FIELDS: readonly ["spaceId", "environmentId", "cmaToken", "host"];
+export type CredentialField = (typeof FIELDS)[number];
+export type CredentialValues = Record<CredentialField, string>;
+interface Key {
+    escape: boolean;
+    tab: boolean;
+    ctrl: boolean;
+}
+export type KeyAction = 'back' | 'next-field' | 'skip' | null;
+export declare function keyAction(input: string, key: Key): KeyAction;
+export declare function nextField(field: CredentialField): CredentialField;
+export declare function normalize(values: CredentialValues): CredentialValues;
+export declare function missingField(values: CredentialValues): boolean;
+export declare function isUnchanged(current: CredentialValues, initial: CredentialValues): boolean;
+export {};

package/dist/src/tui/import/steps/04-credentials/screen.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { type CredentialValues } from './logic.js';
+import { type ValidationResult } from './validate.js';
+export type CredentialsResult = {
+    skipped: false;
+    credentials: CredentialValues;
+} | {
+    skipped: true;
+};
+interface CredentialsScreenProps {
+    onDone: (result: CredentialsResult) => void;
+    onBack: () => void;
+    initial?: Partial<CredentialValues>;
+    validate?: (values: CredentialValues) => Promise<ValidationResult>;
+}
+export declare function CredentialsScreen({ onDone, onBack, initial, validate, }: CredentialsScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/04-credentials/validate.d.ts

@@ -0,0 +1,8 @@
+import type { CredentialValues } from './logic.js';
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateCredentials(values: CredentialValues): Promise<ValidationResult>;

package/dist/src/tui/import/steps/05-token-reuse/logic.d.ts

@@ -0,0 +1,21 @@
+export type { TokenStrategy } from '../06-extraction/types.js';
+export type TokensState = {
+    kind: 'none';
+} | {
+    kind: 'cached';
+    tokensPath: string;
+    sourceChanged: boolean;
+};
+interface InspectInput {
+    rawTokensPath: string;
+    outDir: string;
+    cache: boolean;
+}
+export declare function inspectTokens({ rawTokensPath, outDir, cache }: InspectInput): Promise<TokensState>;
+export declare function gateText({ tokensPath, sourceChanged }: {
+    tokensPath: string;
+    sourceChanged: boolean;
+}): {
+    summary: string;
+    context?: string;
+};

package/dist/src/tui/import/steps/05-token-reuse/screen.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+interface TokenReuseScreenProps {
+    tokensPath: string;
+    sourceChanged: boolean;
+    onReuse: () => void;
+    onRegenerate: () => void;
+    onQuit: () => void;
+}
+export declare function TokenReuseScreen({ tokensPath, sourceChanged, onReuse, onRegenerate, onQuit, }: TokenReuseScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/06-extraction/find-skill-path.d.ts

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

package/dist/src/tui/import/steps/06-extraction/logic.d.ts

@@ -0,0 +1,48 @@
+import type { ExtractAndComposeProgress } from '@contentful/experience-design-system-backend-pipeline';
+import type { ExtractionProgress } from './types.js';
+/** Structured progress events emitted by the orchestrator (extraction + composition). */
+export type ProgressEvent = ExtractAndComposeProgress;
+/**
+ * Every job the stage will run starts on the first frame, so no row appears later as a surprise. A job that does not
+ * apply stays 'idle' and has no row: existing entities need credentials, token definitions need a raw tokens file, and
+ * reused tokens are already complete.
+ */
+export declare function initialProgress(input: {
+    hasCredentials: boolean;
+    hasRawTokens: boolean;
+    reuseTokens: boolean;
+}): ExtractionProgress;
+export declare function applyProgressEvent(progress: ExtractionProgress, event: ProgressEvent): ExtractionProgress;
+/** The rows the screen shows, in the order the wizard showed them. Rows that do not apply are left out. */
+export declare function progressRows(progress: ExtractionProgress, agent: string): Array<{
+    text: string;
+    complete: boolean;
+}>;
+/** True when every job is already done, so the screen would only flash. The wizard shows nothing in this case. */
+export declare function isFullCacheHit(progress: ExtractionProgress): boolean;
+/**
+ * The wizard's step counts: three fixed steps, one more when there is a token stage, two more when components are
+ * imported, and one more when the tokens can be mapped (not known yet at this stage, so it adds nothing here).
+ * Extraction is step 2 when there is a token stage, otherwise step 1.
+ */
+export declare function stepNumbers(input: {
+    hasRawTokens: boolean;
+    skipComponents?: boolean;
+    mapTokensEligible?: boolean | null;
+}): {
+    stepNumber: number;
+    totalSteps: number;
+};
+export declare function noComponentsMessage(projectPath: string): string;
+export declare function agentAuthMessage(agent: string, status: 'not-found' | 'unauthenticated'): string;
+/**
+ * The agent and model the import runs with: what was typed after `--agent` (either `agent` or `agent:model`), else
+ * what `experiences setup` saved, else Claude with no model. Same chain the legacy import command uses.
+ */
+export declare function resolveAgentChoice(flag: string | undefined, stored: {
+    agent?: unknown;
+    agentModel?: unknown;
+}): {
+    agent: string;
+    agentModel?: string;
+};

package/dist/src/tui/import/steps/06-extraction/run.d.ts

@@ -0,0 +1,26 @@
+import { checkAgentAuth, runExtractAndComposeSession, runGenerateTokensSession } from '@contentful/experience-design-system-backend-pipeline';
+import { runSelection } from './selection.js';
+import type { ExtractionInput, ExtractionProgress, ExtractionResult } from './types.js';
+/** The outside world the stage talks to, so the order of events can be tested without a network, an agent or a CLI. */
+export interface ExtractionDeps {
+    checkAgentAuth: typeof checkAgentAuth;
+    fetchEntities: (credentials: NonNullable<ExtractionInput['credentials']>, outDir: string) => Promise<string | null>;
+    runExtractAndComposeSession: typeof runExtractAndComposeSession;
+    runGenerateTokensSession: typeof runGenerateTokensSession;
+    runSelection: typeof runSelection;
+}
+/**
+ * Runs the stage. The jobs overlap exactly as they did when extract was a
+ * subprocess:
+ *
+ *   entities fetch ───────────────────┐
+ *   extract + compose (in-process)    │
+ *     └─ onSessionCreated(id) ────────┴─ selection agent (waits for fetch) ──┐
+ *     └──────────────────────── returns (composition done) ─────────────────┴─ result
+ *   token generation            (only when the tokens are not being reused)
+ *
+ * Selection starts the moment the orchestrator mints the sessionId, so it
+ * overlaps with composition. When more than one job fails, the error reported
+ * is the first of: extract, no components, selection, token generation.
+ */
+export declare function runExtraction(input: ExtractionInput, onProgress: (progress: ExtractionProgress) => void, deps?: ExtractionDeps): Promise<ExtractionResult>;

package/dist/src/tui/import/steps/06-extraction/screen.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { ExtractionProgress } from './types.js';
+interface ExtractionScreenProps {
+    progress: ExtractionProgress;
+    agent: string;
+    stepNumber: number;
+    totalSteps: number;
+}
+export declare function ExtractionScreen({ progress, agent, stepNumber, totalSteps, }: ExtractionScreenProps): React.ReactElement;
+export {};

package/dist/src/tui/import/steps/06-extraction/selection.d.ts

@@ -0,0 +1,18 @@
+import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
+export interface SelectionOptions {
+    sessionId: string;
+    agent: AgentName;
+    model?: string;
+    promptText?: string;
+    promptPath?: string;
+    noCache: boolean;
+}
+/**
+ * The selection agent run, as the legacy wizard ran it.
+ *
+ * Reads the extracted components from the session database and skips the ones already decided (cache keyed by
+ * component hash, prompt hash and CLI version). It asks the agent about the rest, then writes accepted or rejected to
+ * raw_components and stores the new decisions in the cache in one transaction. Throws on a timeout, a non-zero exit,
+ * or a database error.
+ */
+export declare function runSelection(options: SelectionOptions): Promise<void>;

package/dist/src/tui/import/steps/06-extraction/types.d.ts

@@ -0,0 +1,46 @@
+import type { ExtractionHandoff, ImportHandoff } from '@contentful/experience-design-system-types/handoff';
+export type TokenStrategy = ImportHandoff['tokens']['strategy'];
+export interface ExtractionInput {
+    projectPath: string;
+    /** Absolute source files from the path-validation step (collectFiles output). */
+    filePaths: string[];
+    /** Raw tokens file the user pointed at (always set: v2 asks for one). */
+    rawTokensPath: string;
+    /** From the token reuse step. 'reuse' skips token generation entirely. */
+    tokenStrategy: TokenStrategy;
+    /** Null when the user skipped credentials: no existing-entities fetch happens. */
+    credentials: {
+        spaceId: string;
+        environmentId: string;
+        cmaToken: string;
+        host: string;
+    } | null;
+    agent: string;
+    agentModel?: string;
+    promptOverrides: string[];
+    noCache: boolean;
+}
+type CompositionPhase = 'resolving' | 'cache-hit' | 'done' | `agent:${string}`;
+type JobStatus = 'idle' | 'running' | 'complete' | 'failed';
+/** Everything the extracting screen shows. One field per row. */
+export interface ExtractionProgress {
+    scan: {
+        scanned: number;
+        total: number | null;
+    } | null;
+    composition: CompositionPhase;
+    selection: 'running' | 'complete';
+    existingEntities: JobStatus;
+    tokens: JobStatus;
+}
+/** The label the error screen shows, as the wizard labelled it. */
+type ExtractionStepName = 'analyze extract' | 'selection agent' | 'generate tokens' | 'print tokens' | `${string} auth check`;
+export type ExtractionResult = {
+    ok: true;
+    extraction: ExtractionHandoff;
+} | {
+    ok: false;
+    step: ExtractionStepName;
+    message: string;
+};
+export {};

package/dist/src/tui/import/steps/06-extraction/use-extraction.d.ts

@@ -0,0 +1,14 @@
+import type { ExtractionInput, ExtractionProgress, ExtractionResult } from './types.js';
+export type ExtractionState = {
+    status: 'running';
+    progress: ExtractionProgress;
+} | {
+    status: 'done';
+    result: ExtractionResult;
+};
+/**
+ * Runs the extraction stage once for the given input and reports its progress. Passing a different input starts a new
+ * run; passing nothing leaves the stage idle. A run that finishes after the input changed or the screen went away is
+ * ignored.
+ */
+export declare function useExtraction(input: ExtractionInput | undefined): ExtractionState | undefined;

package/dist/src/tui/import/steps/07-scope-gate/cache-check.d.ts

@@ -0,0 +1,17 @@
+export interface CacheCheckInput {
+    sessionId: string;
+    tokensPath: string;
+    agent: string;
+    agentModel?: string;
+    promptOverrides: string[];
+    existingEntitiesPath: string | null;
+    noCache: boolean;
+}
+/**
+ * Runs the generation cache check in-process while the scope gate is open.
+ * Restores cached CDF entries into the pipeline database as a side-effect so
+ * the generate run that follows can skip them. A failed check is
+ * indistinguishable from "nothing cached", as in legacy. INTEG-5050 tracks
+ * surfacing it.
+ */
+export declare function checkGenerationCache(input: CacheCheckInput): Promise<string[]>;

package/{legacy/dist/src/import/tui/scope-gate-columns.d.ts → dist/src/tui/import/steps/07-scope-gate/columns.d.ts}

@@ -1,9 +1,9 @@
-import type { Closure } from '../../analyze/composite-closure.js';
+import type { Closure } from './graph/composite-closure.js';
 /** Structural subset of ScopeComponent needed by these helpers. */
 export interface ScopeComponentLike {
     name: string;
 }
-export type Decision = 'accepted' | 'rejected' | 'undecided';
+import type { Decision } from './types.js';
 export declare const SCOPE_GATE_MAIN_COLUMN_WIDTH = 54;
 export declare const ACCEPTED_COMPONENTS_COLUMN_WIDTH = 36;
 export interface ScopeGatePanelLayout {
@@ -34,3 +34,23 @@ export declare function computeCounters(components: ScopeComponentLike[], closur
     groups: number;
     total: number;
 };
+export declare function sideColumnLabelStyle(input: {
+    isCycle: boolean;
+    isSelected: boolean;
+    focused: boolean;
+}): {
+    nameColor: string | undefined;
+    nameBold: boolean;
+    nameInverse: boolean;
+    nameUnderline: boolean;
+    suffixColor: string | undefined;
+    suffixDim: boolean;
+    suffixInverse: boolean;
+    suffixUnderline: boolean;
+};
+export declare function computeColumnWindow(total: number, cursor: number, visibleCount: number): {
+    start: number;
+    end: number;
+    above: number;
+    below: number;
+};

package/dist/src/tui/import/steps/07-scope-gate/graph/composite-closure.d.ts

@@ -0,0 +1,26 @@
+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 {};