@contentful/experience-design-system-cli 2.37.1-dev-build-c3f4df22.0 → 2.37.1-dev-build-6bfb243f.0

package/dist/index.js

@@ -2121,7 +2121,7 @@ async function runAgent(options) {
     promptLen: prompt.length,
     promptHead: prompt.slice(0, 500)
   });
-  return new Promise((resolve25) => {
+  return new Promise((resolve27) => {
     const bedrockEnv = bedrock ? BEDROCK_ENV_BY_AGENT[agent] : void 0;
     const child = spawn3(binary, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -2170,7 +2170,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve25(result);
+      resolve27(result);
     });
   });
 }
@@ -2192,7 +2192,7 @@ async function checkAgentAuth(agent) {
     return "not-found";
   if (agent !== "claude")
     return "ok";
-  return new Promise((resolve25) => {
+  return new Promise((resolve27) => {
     const child = spawn4(binary, ["auth", "status", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let done = false;
@@ -2201,7 +2201,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve25("unauthenticated");
+      resolve27("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -2212,14 +2212,14 @@ async function checkAgentAuth(agent) {
       done = true;
       clearTimeout(timer);
       if (code !== 0) {
-        resolve25("unauthenticated");
+        resolve27("unauthenticated");
         return;
       }
       try {
         const status = JSON.parse(stdout);
-        resolve25(status.loggedIn ? "ok" : "unauthenticated");
+        resolve27(status.loggedIn ? "ok" : "unauthenticated");
       } catch {
-        resolve25("unauthenticated");
+        resolve27("unauthenticated");
       }
     });
   });
@@ -2229,9 +2229,9 @@ async function binaryIsOnPath(binary) {
     const fs = await import("node:fs/promises");
     return fs.access(binary).then(() => true, () => false);
   }
-  return new Promise((resolve25) => {
+  return new Promise((resolve27) => {
     const child = spawn4(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve25(code === 0));
+    child.on("close", (code) => resolve27(code === 0));
   });
 }
 var init_check_agent_auth = __esm({
@@ -13144,11 +13144,11 @@ var init_load_and_validate_for_review = __esm({
 // packages/experience-design-system-backend-pipeline/dist/src/persistence/src/review-session/repositories/review-session-paths.js
 import { resolve as resolve15 } from "node:path";
 async function getRefineSessionPaths(sessionId, artifactsRoot) {
-  const sessionDir = resolve15(artifactsRoot, sessionId);
+  const sessionDir2 = resolve15(artifactsRoot, sessionId);
   return {
-    sessionDir,
-    eventsPath: resolve15(sessionDir, "events.jsonl"),
-    statePath: resolve15(sessionDir, "current-review-state.json")
+    sessionDir: sessionDir2,
+    eventsPath: resolve15(sessionDir2, "events.jsonl"),
+    statePath: resolve15(sessionDir2, "current-review-state.json")
   };
 }
 var init_review_session_paths = __esm({
@@ -14901,7 +14901,7 @@ function errorMessage(error) {
   return error instanceof Error && error.message ? error.message : String(error);
 }
 function defaultSleep(delayMs) {
-  return new Promise((resolve25) => setTimeout(resolve25, delayMs));
+  return new Promise((resolve27) => setTimeout(resolve27, delayMs));
 }
 var MAX_RETRY_AFTER_MS;
 var init_http_utils = __esm({
@@ -15177,7 +15177,7 @@ var init_api_client = __esm({
             const progress = maxAttempts > 1 ? attempt / (maxAttempts - 1) : 0;
             const baseDelay = intervalMs + (maxIntervalMs - intervalMs) * progress;
             const jitter = Math.random() * baseDelay * 0.15;
-            await new Promise((resolve25) => setTimeout(resolve25, baseDelay + jitter));
+            await new Promise((resolve27) => setTimeout(resolve27, baseDelay + jitter));
           }
         }
         throw new Error(`Operation ${operationId} timed out after ${maxAttempts} attempts`);
@@ -18734,7 +18734,7 @@ async function retryDatabaseWrite(operation, attempts = 8) {
       const message = error instanceof Error ? error.message : String(error);
       if (!/database is locked|database is busy/i.test(message) || attempt >= attempts)
         throw error;
-      await new Promise((resolve25) => setTimeout(resolve25, Math.min(250 * attempt, 2e3)));
+      await new Promise((resolve27) => setTimeout(resolve27, Math.min(250 * attempt, 2e3)));
     }
   }
 }
@@ -20301,11 +20301,34 @@ var init_shared2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/import/steps/05-token-reuse/logic.ts
-import { access as access5, stat as stat4 } from "node:fs/promises";
+import { access as access5, readdir as readdir2, stat as stat4 } from "node:fs/promises";
 import { join as join18 } from "node:path";
-async function inspectTokens({ rawTokensPath, outDir, cache }) {
+async function findLatestTokens(contentfulDir) {
+  const candidates = [join18(contentfulDir, "tokens.json")];
+  try {
+    for (const session of await readdir2(contentfulDir, { withFileTypes: true })) {
+      if (!session.isDirectory()) continue;
+      for (const run of await readdir2(join18(contentfulDir, session.name), { withFileTypes: true }).catch(() => [])) {
+        if (run.isDirectory() && /^dsi-import-\d+$/.test(run.name)) {
+          candidates.push(join18(contentfulDir, session.name, run.name, "tokens.json"));
+        }
+      }
+    }
+  } catch {
+  }
+  const found = [];
+  for (const path5 of candidates) {
+    try {
+      found.push({ path: path5, mtimeMs: (await stat4(path5)).mtimeMs });
+    } catch {
+    }
+  }
+  return found.sort((a, b) => b.mtimeMs - a.mtimeMs)[0]?.path ?? null;
+}
+async function inspectTokens({ rawTokensPath, contentfulDir, cache }) {
   if (!cache) return { kind: "none" };
-  const tokensPath = join18(outDir, "tokens.json");
+  const tokensPath = await findLatestTokens(contentfulDir);
+  if (!tokensPath) return { kind: "none" };
   try {
     await access5(tokensPath);
   } catch {
@@ -20520,13 +20543,12 @@ async function writeSettings2(settings) {
 async function updateSettings2(patch) {
   await writeSettings2({ ...await readSettings2(), ...patch });
 }
-var configFilePath2, runsFilePath2, debugSessionsDir2, oldConfigDir2;
+var configFilePath2, runsFilePath2, oldConfigDir2;
 var init_config = __esm({
   "packages/experience-design-system-types/dist/src/config/index.js"() {
     "use strict";
     configFilePath2 = () => join19(configRoot2(), "config.json");
     runsFilePath2 = () => join19(configRoot2(), "state", "runs.json");
-    debugSessionsDir2 = () => join19(configRoot2(), "debug", "sessions");
     oldConfigDir2 = () => join19(homedir3(), ".config", "experiences");
   }
 });
@@ -20654,7 +20676,7 @@ var init_selection2 = __esm({
 import { mkdir as mkdir7 } from "node:fs/promises";
 import { join as join21, resolve as resolve22 } from "node:path";
 async function runExtraction(input, onProgress, deps = realDeps) {
-  const outDir = join21(resolve22(input.projectPath), ".contentful");
+  const outDir = input.outDir ?? join21(resolve22(input.projectPath), ".contentful");
   let progress = initialProgress({
     hasCredentials: input.credentials !== null,
     hasRawTokens: input.rawTokensPath !== "",
@@ -30170,6 +30192,7 @@ var init_generate_review_step = __esm({
     init_review_input();
     init_use_review_preview();
     init_LivePreviewSummary();
+    init_cycle_auto_reject();
     HELP_SECTIONS2 = [
       {
         title: "Navigation",
@@ -31774,7 +31797,7 @@ var init_save = __esm({
       writeFile: (path5, contents) => writeFile7(path5, contents),
       appendRun,
       buildSourceFingerprint,
-      sleep: (ms) => new Promise((resolve25) => setTimeout(resolve25, ms)),
+      sleep: (ms) => new Promise((resolve27) => setTimeout(resolve27, ms)),
       warn: (message) => process.stderr.write(message)
     });
   }
@@ -31796,7 +31819,7 @@ var init_types9 = __esm({
 import { appendFileSync, writeFileSync } from "node:fs";
 import { mkdir as mkdir8 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join25 } from "node:path";
+import { join as join25, resolve as resolve25 } from "node:path";
 function appendWizardLog(entry) {
   appendFileSync(WIZARD_LOG, JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), ...entry }) + "\n");
 }
@@ -32044,7 +32067,7 @@ function createFlowController(start, deps) {
     },
     async submitPath(submitted) {
       await deps.mkdir(submitted);
-      if (await deps.detectSaveConflict(submitted)) {
+      if (resolve25(submitted) !== resolve25(state.outDir) && await deps.detectSaveConflict(submitted)) {
         const subdir = deps.buildTimestampedSubdir(submitted);
         await deps.mkdir(subdir);
         await proceedToWrite(subdir);
@@ -32132,9 +32155,18 @@ var init_debug_mode_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/debug-store.ts
+var debug_store_exports = {};
+__export(debug_store_exports, {
+  currentDebugSessionDir: () => currentDebugSessionDir,
+  currentSessionDir: () => currentSessionDir,
+  finishDebugRun: () => finishDebugRun,
+  startDebugRun: () => startDebugRun,
+  startDebugSessionIn: () => startDebugSessionIn,
+  startImportRun: () => startImportRun
+});
 import { mkdir as mkdir9, writeFile as writeFile8 } from "node:fs/promises";
 import { existsSync as existsSync11, readdirSync as readdirSync4 } from "node:fs";
-import { join as join26 } from "node:path";
+import { join as join26, resolve as resolve26 } from "node:path";
 function generateRunId() {
   const now = /* @__PURE__ */ new Date();
   const pad = (n) => String(n).padStart(2, "0");
@@ -32147,10 +32179,17 @@ function datePrefix(now = /* @__PURE__ */ new Date()) {
 function slugify(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
-function generateSessionId3() {
+async function readBaseDir() {
+  try {
+    const dir = (await readSettings2())["contentfulBaseDir"];
+    return typeof dir === "string" && dir !== "" ? resolve26(dir) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function nextSessionId(contentfulDir) {
   const today = datePrefix();
-  const root = debugSessionsDir2();
-  const existing = existsSync11(root) ? readdirSync4(root) : [];
+  const existing = existsSync11(contentfulDir) ? readdirSync4(contentfulDir) : [];
   const seqPattern = new RegExp(`^${today}-session-(\\d+)$`);
   const maxSeq = existing.reduce((max, entry) => {
     const match2 = seqPattern.exec(entry);
@@ -32158,11 +32197,38 @@ function generateSessionId3() {
   }, 0);
   return `${today}-session-${maxSeq + 1}`;
 }
-function sessionDebugDir() {
-  return join26(debugSessionsDir2(), SESSION_ID);
+function startSession(base, { replace }) {
+  const contentfulDir = join26(base, ".contentful");
+  if (replace || !sessionDir) sessionDir = join26(contentfulDir, nextSessionId(contentfulDir));
+  return sessionDir;
 }
 function currentDebugSessionDir() {
-  return sessionDebugDir();
+  return sessionDir && join26(sessionDir, "debug");
+}
+function currentSessionDir() {
+  return sessionDir;
+}
+async function startDebugSessionIn(base, { replace = false } = {}) {
+  try {
+    if (!await isDebugModeEnabled()) return;
+    await mkdir9(join26(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
+  } catch {
+  }
+}
+function nextImportRunDir(session) {
+  const existing = existsSync11(session) ? readdirSync4(session) : [];
+  const maxRun = existing.reduce((max, entry) => {
+    const match2 = /^dsi-import-(\d+)$/.exec(entry);
+    return match2 ? Math.max(max, Number(match2[1])) : max;
+  }, 0);
+  return join26(session, `dsi-import-${maxRun + 1}`);
+}
+async function startImportRun(projectPath) {
+  await startDebugSessionIn(projectPath);
+  if (!sessionDir) return join26(resolve26(projectPath), ".contentful");
+  const dir = nextImportRunDir(sessionDir);
+  await mkdir9(dir, { recursive: true });
+  return dir;
 }
 async function isDebugModeEnabled() {
   try {
@@ -32203,8 +32269,10 @@ async function finishDebugRun({
   pendingRun = void 0;
   const durationMs = Date.now() - run.startedAt;
   const content = renderMarkdown(run, { outputs: redact(outputs), status, exitMethod, durationMs });
+  const root = currentDebugSessionDir();
+  if (!root) return;
   const flowSegments = run.flow.split("/");
-  const dir = join26(sessionDebugDir(), ...flowSegments);
+  const dir = join26(root, ...flowSegments);
   await mkdir9(dir, { recursive: true });
   const filename = nextAttemptFilename(dir, run.menuOption);
   await writeFile8(join26(dir, filename), content, { mode: 384 });
@@ -32251,17 +32319,16 @@ ${JSON.stringify(finish.outputs, null, 2)}
 function handleCrash() {
   return finishDebugRun({ outputs: {}, status: "error", exitMethod: "crashed" });
 }
-var pendingRun, SESSION_ID;
+var pendingRun, sessionDir;
 var init_debug_store = __esm({
   "packages/experience-design-system-cli/src/tui/debug-store.ts"() {
     "use strict";
     init_config();
     init_version();
     init_debug_mode_store();
-    SESSION_ID = generateSessionId3();
-    void isDebugModeEnabled().then((enabled) => {
-      if (!enabled) return void 0;
-      return mkdir9(sessionDebugDir(), { recursive: true });
+    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(([enabled, base]) => {
+      if (!enabled || !base) return void 0;
+      return mkdir9(join26(startSession(base, { replace: false }), "debug"), { recursive: true });
     });
     process.once("uncaughtException", (err) => {
       void handleCrash().finally(() => {
@@ -32287,8 +32354,7 @@ async function readHelpInfo() {
   return {
     storage: [
       { label: "Config folder", value: configRoot2() },
-      { label: "Settings file", value: configFilePath2() },
-      { label: "Debug logs", value: debugSessionsDir2() }
+      { label: "Settings file", value: configFilePath2() }
     ],
     troubleshooting: [
       { label: "CLI version", value: readPackageVersion() },
@@ -32297,7 +32363,7 @@ async function readHelpInfo() {
       { label: "Debug Mode", value: debugMode.enabled ? "on" : "off" },
       {
         label: "This session",
-        value: debugMode.enabled ? currentDebugSessionDir() : "no logs written while Debug Mode is off"
+        value: !debugMode.enabled ? "no logs written while Debug Mode is off" : currentDebugSessionDir() ?? "not started: set the Root Project Directory in Settings, or start an import"
       }
     ]
   };
@@ -32454,7 +32520,8 @@ async function readCredentials() {
     cmaToken: store.cmaToken || "",
     host: store.host || "",
     defaultComponentDir: store.defaultComponentDir || "",
-    defaultTokenFile: store.defaultTokenFile || ""
+    defaultTokenFile: store.defaultTokenFile || "",
+    contentfulBaseDir: store.contentfulBaseDir || ""
   };
 }
 async function writeCredentials(config) {
@@ -32487,7 +32554,8 @@ function debugFields(config) {
     cma_token: config?.cmaToken ?? "",
     host: config?.host ?? "",
     default_component_dir: config?.defaultComponentDir ?? "",
-    default_token_file: config?.defaultTokenFile ?? ""
+    default_token_file: config?.defaultTokenFile ?? "",
+    contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
 function ConfigurationScreen({ onDone }) {
@@ -32525,6 +32593,7 @@ function ConfigurationScreen({ onDone }) {
     setNotice(null);
     writeCredentials(config).then(() => {
       setLastSaved(config);
+      if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
       setNotice({ kind: "success", text: "Configuration saved" });
       setStage("form");
     }).catch((err) => {
@@ -32590,10 +32659,7 @@ function ConfigurationScreen({ onDone }) {
       const display = field === "cmaToken" ? "\u2022".repeat(value.length) : value;
       return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
         /* @__PURE__ */ jsx55(Text46, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
-        /* @__PURE__ */ jsxs45(Text46, { bold: isActive, children: [
-          FIELD_LABELS[field],
-          ":"
-        ] }),
+        /* @__PURE__ */ jsx55(Box44, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: FIELD_LABELS[field] }) }),
         isActive && editing ? /* @__PURE__ */ jsx55(
           TextInput4,
           {
@@ -32602,7 +32668,8 @@ function ConfigurationScreen({ onDone }) {
             onSubmit: () => setEditing(false),
             mask: field === "cmaToken" ? "\u2022" : void 0
           }
-        ) : /* @__PURE__ */ jsx55(Text46, { children: display || /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" }) })
+        ) : /* @__PURE__ */ jsx55(Text46, { bold: !!display, children: display || (FIELD_HINTS[field] ? "" : /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" })) }),
+        FIELD_HINTS[field] && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: FIELD_HINTS[field] })
       ] }, field);
     }) }),
     notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
@@ -32633,7 +32700,7 @@ function ConfigurationScreen({ onDone }) {
     )
   ] });
 }
-var FIELD_ORDER, FIELD_LABELS;
+var FIELD_ORDER, FIELD_LABELS, FIELD_HINTS, LABEL_WIDTH;
 var init_ContentfulConfigScreen = __esm({
   "packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx"() {
     "use strict";
@@ -32647,16 +32714,22 @@ var init_ContentfulConfigScreen = __esm({
       "cmaToken",
       "host",
       "defaultComponentDir",
-      "defaultTokenFile"
+      "defaultTokenFile",
+      "contentfulBaseDir"
     ];
     FIELD_LABELS = {
       spaceId: "Space ID",
       environmentId: "Environment ID",
       cmaToken: "CMA Token",
-      host: "API Host (optional)",
-      defaultComponentDir: "Default component directory (optional)",
-      defaultTokenFile: "Default token file (optional)"
+      host: "API Host",
+      defaultComponentDir: "Default component directory",
+      defaultTokenFile: "Default token file",
+      contentfulBaseDir: "Root Project Directory"
+    };
+    FIELD_HINTS = {
+      contentfulBaseDir: "(where .contentful goes)"
     };
+    LABEL_WIDTH = Math.max(...Object.values(FIELD_LABELS).map((label) => label.length));
   }
 });
 
@@ -32950,7 +33023,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state = await inspectTokens({
       rawTokensPath: tokens,
-      outDir: join27(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join27(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state.kind === "cached") {
@@ -32971,6 +33044,7 @@ function App({ importOptions, inkClear }) {
     const settings = await readSettings2();
     const { agent, agentModel } = resolveAgentChoice(launch.agent, settings);
     const generatePromptPath = typeof settings.generatePromptPath === "string" ? settings.generatePromptPath : void 0;
+    const outDir = await (await Promise.resolve().then(() => (init_debug_store(), debug_store_exports))).startImportRun(resolveUserPath(launch.projectPath ?? ""));
     setExtractionRun({
       ...generatePromptPath ? { generatePromptPath } : {},
       // the later steps get the same agent, so they use what the stage used
@@ -32979,6 +33053,7 @@ function App({ importOptions, inkClear }) {
       tokenStrategy,
       input: {
         projectPath: resolveUserPath(launch.projectPath ?? ""),
+        outDir,
         filePaths: launch.filePaths ?? [],
         rawTokensPath: launch.tokens ?? "",
         tokenStrategy,
@@ -33325,14 +33400,14 @@ function runDevWatch(args) {
     process.stderr.write("--watch only works from a checkout of the repo (scripts/dev.mjs is not in the package).\n");
     return Promise.resolve(1);
   }
-  return new Promise((resolve25) => {
+  return new Promise((resolve27) => {
     const child = spawn2(process.execPath, [script, ...args], { stdio: "inherit" });
     process.on("SIGINT", () => void 0);
-    child.on("exit", (code) => resolve25(code ?? 0));
+    child.on("exit", (code) => resolve27(code ?? 0));
     child.on("error", (err) => {
       process.stderr.write(`${err.message}
 `);
-      resolve25(1);
+      resolve27(1);
     });
   });
 }

package/dist/package.json

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

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

@@ -1,6 +1,23 @@
 type Status = 'success' | 'error';
 type ExitMethod = 'saved' | 'discarded' | 'crashed';
-export declare function currentDebugSessionDir(): string;
+export declare function currentDebugSessionDir(): string | undefined;
+/** This terminal session's folder, `<base>/.contentful/<session>/`, or undefined until it is known. */
+export declare function currentSessionDir(): string | undefined;
+/**
+ * Starts this terminal session's folder in `base`. The base directory setting being saved passes `replace` so the new
+ * location wins; the import passes nothing and only starts a session when none exists yet. Fail-open like the rest of
+ * the logger.
+ */
+export declare function startDebugSessionIn(base: string, { replace }?: {
+    replace?: boolean | undefined;
+}): Promise<void>;
+/**
+ * Where this import run writes everything it produces (tokens.json, .existing-entities.json, components.json): a new
+ * `dsi-import-N` folder in this session's folder, next to the debug logs. The session is started here, and waited for,
+ * so the answer does not depend on how quickly the boot-time start finished. Without a session (Debug Mode off, or a
+ * folder that cannot be created) the files stay in `<project>/.contentful`, as before.
+ */
+export declare function startImportRun(projectPath: string): Promise<string>;
 export declare function startDebugRun({ flow, step, menuOption, inputs, }: {
     flow: string;
     step: string;

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

@@ -1,2 +1,10 @@
-import type { ScanResult } from '../logic.js';
+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

@@ -32,6 +32,10 @@ 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;

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

@@ -8,10 +8,11 @@ export type TokensState = {
 };
 interface InspectInput {
     rawTokensPath: string;
-    outDir: string;
+    /** The `.contentful` folder: the sessions' `dsi-import` folders sit inside it, and an older `tokens.json` may sit in it. */
+    contentfulDir: string;
     cache: boolean;
 }
-export declare function inspectTokens({ rawTokensPath, outDir, cache }: InspectInput): Promise<TokensState>;
+export declare function inspectTokens({ rawTokensPath, contentfulDir, cache }: InspectInput): Promise<TokensState>;
 export declare function gateText({ tokensPath, sourceChanged }: {
     tokensPath: string;
     sourceChanged: boolean;

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

@@ -2,6 +2,8 @@ import type { ExtractionHandoff, ImportHandoff } from '@contentful/experience-de
 export type TokenStrategy = ImportHandoff['tokens']['strategy'];
 export interface ExtractionInput {
     projectPath: string;
+    /** Where the stage writes tokens.json and the other files. Defaults to `<projectPath>/.contentful`. */
+    outDir?: 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). */

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

@@ -4,6 +4,8 @@ export interface ScopeComponentLike {
     name: string;
 }
 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 {
     height: number;
     mainVisibleCount: number;

package/dist/src/tui/import/steps/07-scope-gate/graph/fuzzy-search.d.ts

@@ -1 +1,3 @@
 export declare function fuzzyMatches(query: string, text: string): boolean;
+export declare function fuzzyScore(query: string, text: string): number | null;
+export declare function fuzzyFilter(query: string, candidates: string[]): string[];

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

@@ -3,5 +3,27 @@ export interface LineageParentEdge {
     parent: string;
     slotName: string;
 }
+export interface LineageEdge {
+    from: string;
+    slotName: string;
+    to: string;
+}
+export type LineageChain = LineageEdge[];
 export declare function findDirectParents(target: string, components: ComponentGraphNode[]): LineageParentEdge[];
 export declare function findAllAncestors(target: string, components: ComponentGraphNode[]): Set<string>;
+export declare function findAllAncestorChains(target: string, components: ComponentGraphNode[]): LineageChain[];
+export interface AncestorTreeNode {
+    name: string;
+    incomingSlotName?: string;
+    depth: number;
+    shared: boolean;
+    cycle: boolean;
+    parents: AncestorTreeNode[];
+}
+export declare function buildAncestorTree(target: string, components: ComponentGraphNode[]): AncestorTreeNode;
+export interface AncestorTreeLine {
+    text: string;
+    jumpTarget?: string;
+    depth: number;
+}
+export declare function renderAncestorTree(node: AncestorTreeNode): AncestorTreeLine[];

package/dist/src/tui/import/steps/07-scope-gate/sidebar/ai-flag.d.ts

@@ -3,3 +3,4 @@ export type AiFlaggable = {
     needsReview?: boolean;
 };
 export declare function isAiFlagged(row: AiFlaggable): boolean;
+export declare function isDefaultIncluded(row: AiFlaggable): boolean;

package/dist/src/tui/import/steps/07-scope-gate/sidebar/components/GroupedSidebar.d.ts

@@ -56,5 +56,38 @@ export declare function buildVisibleRows(props: {
     graph: ComponentGraphNode[];
     filterVisibleKeys?: Set<string>;
 }): VisibleRow[];
+export declare function visibleItemOrder(props: {
+    items: GroupedSidebarItem[];
+    cycleParticipants: Set<string>;
+    expandedGroups: Set<string>;
+    alwaysExpanded?: boolean;
+    showFlatTier?: boolean;
+    graph: ComponentGraphNode[];
+}): number[];
+export declare function labelStyleFor(input: {
+    row: VisibleRow;
+    isCursor: boolean;
+    wouldDim: boolean;
+}): {
+    color: string | undefined;
+    bold: boolean;
+    dim: boolean;
+};
+export declare function selectionGlyphStyleFor(selState: 'accepted' | 'rejected' | 'undecided' | undefined, isCycleRow: boolean): {
+    glyph: string | null;
+    color: string | undefined;
+    dim: boolean;
+    bold: boolean;
+};
+export declare function inheritanceGlyphStyleFor(input: {
+    status: RenderStatus['status'] | undefined;
+    isOwn: boolean;
+    isCursor: boolean;
+}): {
+    glyph: string | null;
+    color: string | undefined;
+    dim: boolean;
+    bold: boolean;
+};
 export declare function GroupedSidebar(props: GroupedSidebarProps): React.ReactElement;
 export {};