@contentful/experience-design-system-cli 2.35.1-dev-build-7780c1f7.0 → 2.35.1-dev-build-215f38d1.0

package/dist/index.js

@@ -297,6 +297,245 @@ var init_PageContainer = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/import/steps/01-welcome/logic.ts
+function shouldQuit(value, input, key) {
+  if (key.escape) return true;
+  return value === "" && input === "q" && !key.ctrl && !key.meta;
+}
+function toProjectPath(value) {
+  const projectPath = value.trim();
+  return projectPath === "" ? null : projectPath;
+}
+var init_logic = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/01-welcome/logic.ts"() {
+    "use strict";
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/01-welcome/controls.ts
+import { useInput as useInput3 } from "ink";
+function useWelcomeControls(projectPath, onQuit) {
+  useInput3((input, key) => {
+    if (shouldQuit(projectPath, input, key)) onQuit();
+  });
+}
+var WELCOME_CONTROLS;
+var init_controls = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/01-welcome/controls.ts"() {
+    "use strict";
+    init_logic();
+    WELCOME_CONTROLS = [
+      { keys: "Enter", label: "Continue" },
+      { keys: "Esc/q", label: "Back to menu" }
+    ];
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx
+import { useState as useState3 } from "react";
+import { Box as Box3, Text as Text3 } from "ink";
+import TextInput from "ink-text-input";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function WelcomeScreen({ onContinue, onQuit }) {
+  const [projectPath, setProjectPath] = useState3("");
+  useWelcomeControls(projectPath, onQuit);
+  const submit = (value) => {
+    const path = toProjectPath(value);
+    if (path) onContinue(path);
+  };
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx3(Text3, { bold: true, color: PALETTE.success, children: "\u{1F44B} Hey! Let's import your design system into Contentful." }),
+    /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "I'll walk you through 5 steps to get your components into Contentful ExO." }),
+    /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: RULE }),
+      OVERVIEW.map((item) => /* @__PURE__ */ jsxs3(Box3, { gap: 1, children: [
+        /* @__PURE__ */ jsx3(Text3, { bold: true, children: item.label }),
+        /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: item.description })
+      ] }, item.label)),
+      /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: RULE })
+    ] }),
+    /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsx3(Text3, { children: "Where is your component library?" }),
+      /* @__PURE__ */ jsxs3(Box3, { gap: 1, children: [
+        /* @__PURE__ */ jsx3(Text3, { color: PALETTE.accent, children: "?" }),
+        /* @__PURE__ */ jsx3(Text3, { children: "Project path:" }),
+        /* @__PURE__ */ jsx3(TextInput, { value: projectPath, onChange: setProjectPath, onSubmit: submit })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx3(Box3, { marginTop: 1, gap: 3, children: WELCOME_CONTROLS.map((control) => /* @__PURE__ */ jsxs3(Text3, { dimColor: true, children: [
+      "[",
+      control.keys,
+      "] ",
+      control.label
+    ] }, control.keys)) })
+  ] });
+}
+var RULE, OVERVIEW;
+var init_screen = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/01-welcome/screen.tsx"() {
+    "use strict";
+    init_home_theme();
+    init_controls();
+    init_logic();
+    RULE = "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500";
+    OVERVIEW = [
+      { label: "Step 1", description: "Extract components from your codebase" },
+      { label: "Step 2", description: "Review what was extracted" },
+      { label: "Step 3", description: "Generate CDF definitions with Claude" },
+      { label: "Step 4", description: "Review generated definitions" },
+      { label: "Step 5", description: "Push to Contentful" }
+    ];
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/02-token-input/logic.ts
+function isPlainKeyOnEmptyField(value, input, key, expected) {
+  return value === "" && input === expected && !key.ctrl && !key.meta;
+}
+function shouldGoBack(value, input, key) {
+  return key.escape || isPlainKeyOnEmptyField(value, input, key, "q");
+}
+function shouldSkip(value, input, key) {
+  return isPlainKeyOnEmptyField(value, input, key, "s");
+}
+function toTokenPath(value) {
+  const tokenPath = value.trim();
+  return tokenPath === "" ? null : tokenPath;
+}
+var init_logic2 = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/02-token-input/logic.ts"() {
+    "use strict";
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/02-token-input/controls.ts
+import { useInput as useInput4 } from "ink";
+function useTokenInputControls(tokenPath, onSkip, onBack) {
+  useInput4((input, key) => {
+    if (shouldGoBack(tokenPath, input, key)) onBack();
+    else if (shouldSkip(tokenPath, input, key)) onSkip();
+  });
+}
+var TOKEN_INPUT_CONTROLS;
+var init_controls2 = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/02-token-input/controls.ts"() {
+    "use strict";
+    init_logic2();
+    TOKEN_INPUT_CONTROLS = [
+      { keys: "Enter", label: "Continue (skips if empty)" },
+      { keys: "s", label: "Skip" },
+      { keys: "Esc/q", label: "Back" }
+    ];
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/02-token-input/validate-path.ts
+import { statSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+function stripQuotes(value) {
+  const quoted = value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'");
+  return value.length >= 2 && quoted ? value.slice(1, -1) : value;
+}
+function expandHome(value) {
+  return value === "~" || value.startsWith("~/") || value.startsWith("~\\") ? homedir() + value.slice(1) : value;
+}
+function validateTokenPath(rawPath) {
+  const path = resolve(expandHome(stripQuotes(rawPath.trim())));
+  let stats;
+  try {
+    stats = statSync(path);
+  } catch {
+    return { ok: false, error: `Path not found: ${path}`, resolvedPath: path };
+  }
+  if (stats.isDirectory()) {
+    return {
+      ok: false,
+      error: "That's a directory \u2014 provide a path to a token file (e.g. tokens.json), not a folder.",
+      resolvedPath: path
+    };
+  }
+  if (!stats.isFile()) {
+    return { ok: false, error: `Not a regular file: ${path}`, resolvedPath: path };
+  }
+  return { ok: true, path };
+}
+var init_validate_path = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/02-token-input/validate-path.ts"() {
+    "use strict";
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/02-token-input/screen.tsx
+import { useState as useState4 } from "react";
+import { Box as Box4, Text as Text4 } from "ink";
+import TextInput2 from "ink-text-input";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function TokenInputScreen({ onConfirm, onSkip, onBack }) {
+  const [tokenPath, setTokenPath] = useState4("");
+  const [failure, setFailure] = useState4(null);
+  useTokenInputControls(tokenPath, onSkip, onBack);
+  const change = (value) => {
+    setTokenPath(value);
+    setFailure(null);
+  };
+  const submit = (value) => {
+    const rawPath = toTokenPath(value);
+    if (!rawPath) {
+      onSkip();
+      return;
+    }
+    const check = validateTokenPath(rawPath);
+    if (check.ok) onConfirm(check.path);
+    else setFailure({ error: check.error, resolvedPath: check.resolvedPath });
+  };
+  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx4(Text4, { bold: true, children: "Design tokens" }),
+    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "Point me to your raw token file (e.g. ~/design-tokens/tokens.json). You can use ~, relative, or absolute paths. Claude will map it to DTCG format." }),
+    /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsxs4(Box4, { gap: 1, children: [
+        /* @__PURE__ */ jsx4(Text4, { color: PALETTE.accent, children: "?" }),
+        /* @__PURE__ */ jsx4(Text4, { children: "Token path:" }),
+        /* @__PURE__ */ jsx4(TextInput2, { value: tokenPath, onChange: change, onSubmit: submit })
+      ] }),
+      failure && /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsxs4(Text4, { color: PALETTE.error, children: [
+          "\u2717 ",
+          failure.error
+        ] }),
+        /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
+          " Resolved to: ",
+          failure.resolvedPath
+        ] })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx4(Box4, { marginTop: 1, gap: 3, children: TOKEN_INPUT_CONTROLS.map((control) => /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
+      "[",
+      control.keys,
+      "] ",
+      control.label
+    ] }, control.keys)) })
+  ] });
+}
+var init_screen2 = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/02-token-input/screen.tsx"() {
+    "use strict";
+    init_home_theme();
+    init_controls2();
+    init_logic2();
+    init_validate_path();
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/import/steps/index.ts
+var init_steps = __esm({
+  "packages/experience-design-system-cli/src/tui/import/steps/index.ts"() {
+    "use strict";
+    init_screen();
+    init_screen2();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/import/spawn-v1-import.ts
 import { spawn as spawn2 } from "node:child_process";
 function buildArgs(options) {
@@ -304,6 +543,12 @@ function buildArgs(options) {
   if (options.project) {
     args.push("--project", options.project);
   }
+  if (options.tokens) {
+    args.push("--tokens", options.tokens);
+  }
+  if (options.skipTokenPrompt) {
+    args.push("--skip-token-prompt");
+  }
   return args;
 }
 async function spawnV1Import(options = {}) {
@@ -333,7 +578,7 @@ function getTerminalHandle() {
   return process.stdin._handle;
 }
 async function stopReadingTerminal() {
-  await new Promise((resolve) => setImmediate(resolve));
+  await new Promise((resolve2) => setImmediate(resolve2));
   const handle = getTerminalHandle();
   if (!handle?.readStop) return;
   handle.reading = false;
@@ -537,8 +782,8 @@ var init_debug_store = __esm({
 
 // packages/experience-design-system-cli/src/tui/help/PageContainer.tsx
 import { useEffect as useEffect3 } from "react";
-import { Box as Box3, Text as Text3, useInput as useInput3 } from "ink";
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+import { Box as Box5, Text as Text5, useInput as useInput5 } from "ink";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function HelpScreen({ onDone }) {
   useEffect3(() => {
     startDebugRun({ flow: "help", step: "01-help", menuOption: "Help", inputs: {} });
@@ -547,7 +792,7 @@ function HelpScreen({ onDone }) {
     void finishDebugRun({ outputs: {}, status: "success", exitMethod });
     onDone();
   };
-  useInput3((input, key) => {
+  useInput5((input, key) => {
     if (key.return) {
       leave("saved");
       return;
@@ -557,12 +802,12 @@ function HelpScreen({ onDone }) {
       return;
     }
   });
-  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx3(Text3, { bold: true, children: "Help" }),
-    /* @__PURE__ */ jsx3(Text3, { children: " " }),
-    /* @__PURE__ */ jsx3(Text3, { children: "This is a placeholder screen for v2 help content." }),
-    /* @__PURE__ */ jsx3(Text3, { children: " " }),
-    /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "[Enter] Complete [Esc/q] Exit \u2014 both return to Start" })
+  return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx5(Text5, { bold: true, children: "Help" }),
+    /* @__PURE__ */ jsx5(Text5, { children: " " }),
+    /* @__PURE__ */ jsx5(Text5, { children: "This is a placeholder screen for v2 help content." }),
+    /* @__PURE__ */ jsx5(Text5, { children: " " }),
+    /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[Enter] Complete [Esc/q] Exit \u2014 both return to Start" })
   ] });
 }
 var init_PageContainer2 = __esm({
@@ -573,20 +818,20 @@ var init_PageContainer2 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/PageContainer.tsx
-import { useState as useState3 } from "react";
-import { Box as Box4, Text as Text4, useInput as useInput4 } from "ink";
-import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+import { useState as useState5 } from "react";
+import { Box as Box6, Text as Text6, useInput as useInput6 } from "ink";
+import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 function SettingsScreen({
   onNavigate,
   onBack
 }) {
-  const [focusIdx, setFocusIdx] = useState3(0);
+  const [focusIdx, setFocusIdx] = useState5(0);
   const items = [
     { label: "Configuration", screen: "settings-configuration" },
     { label: "Opt-in Analytics", screen: "settings-opt-in-analytics" },
     { label: "Debug Mode", screen: "settings-debug-mode" }
   ];
-  useInput4((input, key) => {
+  useInput6((input, key) => {
     if (key.upArrow) {
       setFocusIdx((i) => (i - 1 + items.length) % items.length);
       return;
@@ -606,15 +851,15 @@ function SettingsScreen({
       onBack();
     }
   });
-  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx4(Text4, { bold: true, children: "Settings" }),
-    /* @__PURE__ */ jsx4(Text4, { children: " " }),
-    items.map((item, i) => /* @__PURE__ */ jsxs4(Text4, { color: i === focusIdx ? "cyan" : void 0, children: [
+  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx6(Text6, { bold: true, children: "Settings" }),
+    /* @__PURE__ */ jsx6(Text6, { children: " " }),
+    items.map((item, i) => /* @__PURE__ */ jsxs6(Text6, { color: i === focusIdx ? "cyan" : void 0, children: [
       i === focusIdx ? "> " : "  ",
       item.label
     ] }, item.label)),
-    /* @__PURE__ */ jsx4(Text4, { children: " " }),
-    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "[\u2191/\u2193] Navigate [Enter] Select [Esc/q] Back to Start" })
+    /* @__PURE__ */ jsx6(Text6, { children: " " }),
+    /* @__PURE__ */ jsx6(Text6, { dimColor: true, children: "[\u2191/\u2193] Navigate [Enter] Select [Esc/q] Back to Start" })
   ] });
 }
 var init_PageContainer3 = __esm({
@@ -626,7 +871,7 @@ var init_PageContainer3 = __esm({
 // packages/experience-design-system-cli/src/tui/settings/utils/v1-store.ts
 import { readFile as readFile2, writeFile as writeFile3, mkdir as mkdir3 } from "node:fs/promises";
 import { join as join6 } from "node:path";
-import { homedir } from "node:os";
+import { homedir as homedir2 } from "node:os";
 async function readV1Store() {
   try {
     const raw = await readFile2(V1_STORE_PATH, "utf8");
@@ -636,7 +881,7 @@ async function readV1Store() {
   }
 }
 async function writeV1Store(data) {
-  await mkdir3(join6(homedir(), ".config", "experiences"), { recursive: true });
+  await mkdir3(join6(homedir2(), ".config", "experiences"), { recursive: true });
   await writeFile3(V1_STORE_PATH, `${JSON.stringify(data, null, 2)}
 `, { mode: 384 });
 }
@@ -644,7 +889,7 @@ var V1_STORE_PATH;
 var init_v1_store = __esm({
   "packages/experience-design-system-cli/src/tui/settings/utils/v1-store.ts"() {
     "use strict";
-    V1_STORE_PATH = join6(homedir(), ".config", "experiences", "credentials.json");
+    V1_STORE_PATH = join6(homedir2(), ".config", "experiences", "credentials.json");
   }
 });
 
@@ -677,9 +922,9 @@ var init_config_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect4, useState as useState4 } from "react";
-import { Box as Box5, Text as Text5, useInput as useInput5 } from "ink";
-import { Fragment, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+import { useEffect as useEffect4, useState as useState6 } from "react";
+import { Box as Box7, Text as Text7, useInput as useInput7 } from "ink";
+import { Fragment, jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
 function debugFields(config) {
   return {
     space_id: config?.spaceId ?? "",
@@ -689,10 +934,10 @@ function debugFields(config) {
   };
 }
 function ConfigurationScreen({ onDone }) {
-  const [stage, setStage] = useState4("loading");
-  const [config, setConfig] = useState4(null);
-  const [activeField, setActiveField] = useState4("spaceId");
-  const [message, setMessage] = useState4(null);
+  const [stage, setStage] = useState6("loading");
+  const [config, setConfig] = useState6(null);
+  const [activeField, setActiveField] = useState6("spaceId");
+  const [message, setMessage] = useState6(null);
   useEffect4(() => {
     readCredentials().then((cfg) => {
       setConfig(cfg);
@@ -725,7 +970,7 @@ function ConfigurationScreen({ onDone }) {
       setStage("form");
     });
   }
-  useInput5((input, key) => {
+  useInput7((input, key) => {
     if (stage === "loading" || stage === "saving") return;
     if (stage === "saved") {
       if (key.return || key.escape || input === "q") {
@@ -768,51 +1013,51 @@ function ConfigurationScreen({ onDone }) {
     }
   });
   if (stage === "loading") {
-    return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-      /* @__PURE__ */ jsx5(Text5, { bold: true, children: "Configuration" }),
-      /* @__PURE__ */ jsx5(Text5, { children: " " }),
-      /* @__PURE__ */ jsx5(Text5, { color: PALETTE.accent, children: "Loading..." })
+    return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx7(Text7, { bold: true, children: "Configuration" }),
+      /* @__PURE__ */ jsx7(Text7, { children: " " }),
+      /* @__PURE__ */ jsx7(Text7, { color: PALETTE.accent, children: "Loading..." })
     ] });
   }
   if (stage === "saved") {
-    return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-      /* @__PURE__ */ jsx5(Text5, { bold: true, children: "Configuration" }),
-      /* @__PURE__ */ jsx5(Text5, { children: " " }),
-      /* @__PURE__ */ jsxs5(Text5, { color: PALETTE.success, children: [
+    return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx7(Text7, { bold: true, children: "Configuration" }),
+      /* @__PURE__ */ jsx7(Text7, { children: " " }),
+      /* @__PURE__ */ jsxs7(Text7, { color: PALETTE.success, children: [
         "\u2713 ",
         message
       ] }),
-      /* @__PURE__ */ jsx5(Text5, { children: " " }),
-      /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[Enter] Back to Settings" })
+      /* @__PURE__ */ jsx7(Text7, { children: " " }),
+      /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "[Enter] Back to Settings" })
     ] });
   }
-  return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx5(Text5, { bold: true, children: "Configuration" }),
-    /* @__PURE__ */ jsx5(Text5, { children: " " }),
-    /* @__PURE__ */ jsx5(Text5, { children: "Contentful API Credentials" }),
-    /* @__PURE__ */ jsx5(Text5, { children: " " }),
-    /* @__PURE__ */ jsx5(Box5, { flexDirection: "column", children: FIELD_ORDER.map((field) => {
+  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx7(Text7, { bold: true, children: "Configuration" }),
+    /* @__PURE__ */ jsx7(Text7, { children: " " }),
+    /* @__PURE__ */ jsx7(Text7, { children: "Contentful API Credentials" }),
+    /* @__PURE__ */ jsx7(Text7, { children: " " }),
+    /* @__PURE__ */ jsx7(Box7, { flexDirection: "column", children: FIELD_ORDER.map((field) => {
       const isActive = activeField === field;
       const value = fieldValue(field);
       const display = field === "cmaToken" ? "\u2022".repeat(value.length) : value;
-      return /* @__PURE__ */ jsxs5(Box5, { gap: 1, children: [
-        /* @__PURE__ */ jsx5(Text5, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
-        /* @__PURE__ */ jsxs5(Text5, { bold: isActive, children: [
+      return /* @__PURE__ */ jsxs7(Box7, { gap: 1, children: [
+        /* @__PURE__ */ jsx7(Text7, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
+        /* @__PURE__ */ jsxs7(Text7, { bold: isActive, children: [
           FIELD_LABELS[field],
           ":"
         ] }),
-        /* @__PURE__ */ jsx5(Text5, { children: display || /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "(empty)" }) })
+        /* @__PURE__ */ jsx7(Text7, { children: display || /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "(empty)" }) })
       ] }, field);
     }) }),
-    message && /* @__PURE__ */ jsxs5(Fragment, { children: [
-      /* @__PURE__ */ jsx5(Text5, { children: " " }),
-      /* @__PURE__ */ jsxs5(Text5, { color: PALETTE.error, children: [
+    message && /* @__PURE__ */ jsxs7(Fragment, { children: [
+      /* @__PURE__ */ jsx7(Text7, { children: " " }),
+      /* @__PURE__ */ jsxs7(Text7, { color: PALETTE.error, children: [
         "\u2717 ",
         message
       ] })
     ] }),
-    /* @__PURE__ */ jsx5(Text5, { children: " " }),
-    /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "[\u2191/\u2193] Switch field \xB7 [Enter] Save/Next \xB7 [Esc/q] Back" })
+    /* @__PURE__ */ jsx7(Text7, { children: " " }),
+    /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "[\u2191/\u2193] Switch field \xB7 [Enter] Save/Next \xB7 [Esc/q] Back" })
   ] });
 }
 var FIELD_ORDER, FIELD_LABELS;
@@ -854,12 +1099,12 @@ var init_analytics_store = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect5, useState as useState5 } from "react";
-import { Box as Box6, Text as Text6, useInput as useInput6 } from "ink";
-import { Fragment as Fragment2, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+import { useEffect as useEffect5, useState as useState7 } from "react";
+import { Box as Box8, Text as Text8, useInput as useInput8 } from "ink";
+import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
-  const [loading, setLoading] = useState5(true);
-  const [enabled, setEnabled] = useState5(true);
+  const [loading, setLoading] = useState7(true);
+  const [enabled, setEnabled] = useState7(true);
   useEffect5(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
@@ -872,7 +1117,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput6((input, key) => {
+  useInput8((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -887,24 +1132,24 @@ function OptInAnalyticsScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx6(Text6, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
-    /* @__PURE__ */ jsx6(Text6, { children: " " }),
-    loading ? /* @__PURE__ */ jsx6(Text6, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs6(Fragment2, { children: [
-      /* @__PURE__ */ jsxs6(Text6, { children: [
+  return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
+    /* @__PURE__ */ jsx8(Text8, { children: " " }),
+    loading ? /* @__PURE__ */ jsx8(Text8, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs8(Fragment2, { children: [
+      /* @__PURE__ */ jsxs8(Text8, { children: [
         "Share anonymous usage data:",
         " ",
-        /* @__PURE__ */ jsx6(Text6, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+        /* @__PURE__ */ jsx8(Text8, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
       ] }),
-      /* @__PURE__ */ jsx6(Text6, { children: " " }),
-      /* @__PURE__ */ jsx6(Text6, { dimColor: true, children: "Shares which CLI commands are used and where imports succeed or fail." }),
-      /* @__PURE__ */ jsx6(Text6, { dimColor: true, children: "Never includes source code, file paths, credentials, or authored content." })
+      /* @__PURE__ */ jsx8(Text8, { children: " " }),
+      /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "Shares which CLI commands are used and where imports succeed or fail." }),
+      /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "Never includes source code, file paths, credentials, or authored content." })
     ] }),
-    /* @__PURE__ */ jsx6(Text6, { children: " " }),
-    /* @__PURE__ */ jsx6(Text6, { dimColor: true, children: "[Enter/Space] Toggle [Esc/q] Back to Settings" })
+    /* @__PURE__ */ jsx8(Text8, { children: " " }),
+    /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "[Enter/Space] Toggle [Esc/q] Back to Settings" })
   ] });
 }
-var init_screen = __esm({
+var init_screen3 = __esm({
   "packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx"() {
     "use strict";
     init_home_theme();
@@ -914,11 +1159,11 @@ var init_screen = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect6, useState as useState6 } from "react";
-import { Box as Box7, Text as Text7, useInput as useInput7 } from "ink";
-import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
+import { useEffect as useEffect6, useState as useState8 } from "react";
+import { Box as Box9, Text as Text9, useInput as useInput9 } from "ink";
+import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
 function UpgradeScreen({ onDone }) {
-  const [upgradeCheck, setUpgradeCheck] = useState6();
+  const [upgradeCheck, setUpgradeCheck] = useState8();
   useEffect6(() => {
     startDebugRun({
       flow: "upgrade",
@@ -928,7 +1173,7 @@ function UpgradeScreen({ onDone }) {
     });
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
-  useInput7((_input, key) => {
+  useInput9((_input, key) => {
     if (key.return) {
       void finishDebugRun({
         outputs: upgradeCheck ?? {},
@@ -939,12 +1184,12 @@ function UpgradeScreen({ onDone }) {
       return;
     }
   });
-  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx7(Text7, { bold: true, children: "Upgrade" }),
-    /* @__PURE__ */ jsx7(Text7, { children: " " }),
+  return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx9(Text9, { bold: true, children: "Upgrade" }),
+    /* @__PURE__ */ jsx9(Text9, { children: " " }),
     renderBody(upgradeCheck),
-    /* @__PURE__ */ jsx7(Text7, { children: " " }),
-    /* @__PURE__ */ jsxs7(Text7, { bold: true, color: PALETTE.accent, children: [
+    /* @__PURE__ */ jsx9(Text9, { children: " " }),
+    /* @__PURE__ */ jsxs9(Text9, { bold: true, color: PALETTE.accent, children: [
       FOCUS_MARKER,
       " Go Back"
     ] })
@@ -952,34 +1197,34 @@ function UpgradeScreen({ onDone }) {
 }
 function renderBody(upgradeCheck) {
   if (!upgradeCheck) {
-    return /* @__PURE__ */ jsx7(Text7, { color: PALETTE.muted, children: "Checking for updates\u2026" });
+    return /* @__PURE__ */ jsx9(Text9, { color: PALETTE.muted, children: "Checking for updates\u2026" });
   }
   if (upgradeCheck.status === "error") {
-    return /* @__PURE__ */ jsx7(Text7, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
+    return /* @__PURE__ */ jsx9(Text9, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
   }
   if (upgradeCheck.status === "up-to-date") {
-    return /* @__PURE__ */ jsxs7(Text7, { color: PALETTE.success, children: [
+    return /* @__PURE__ */ jsxs9(Text9, { color: PALETTE.success, children: [
       "You're already on the latest version (v",
       upgradeCheck.current,
       ")."
     ] });
   }
-  return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs7(Text7, { color: PALETTE.muted, children: [
-      /* @__PURE__ */ jsxs7(Text7, { bold: true, color: PALETTE.success, children: [
+  return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs9(Text9, { color: PALETTE.muted, children: [
+      /* @__PURE__ */ jsxs9(Text9, { bold: true, color: PALETTE.success, children: [
         "v",
         upgradeCheck.latest
       ] }),
       " ",
       "is available (you're on ",
-      /* @__PURE__ */ jsxs7(Text7, { bold: true, children: [
+      /* @__PURE__ */ jsxs9(Text9, { bold: true, children: [
         "v",
         upgradeCheck.current
       ] }),
       "). Exit this program, cd into the root of your local clone of contentful/experience-design-system-sdk-public, then run:"
     ] }),
-    /* @__PURE__ */ jsx7(Text7, { children: " " }),
-    /* @__PURE__ */ jsx7(Box7, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx7(Text7, { bold: true, children: cmd }, cmd)) })
+    /* @__PURE__ */ jsx9(Text9, { children: " " }),
+    /* @__PURE__ */ jsx9(Box9, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx9(Text9, { bold: true, children: cmd }, cmd)) })
   ] });
 }
 var UPGRADE_COMMANDS;
@@ -994,12 +1239,12 @@ var init_PageContainer4 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect7, useState as useState7 } from "react";
-import { Box as Box8, Text as Text8, useInput as useInput8 } from "ink";
-import { jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
+import { useEffect as useEffect7, useState as useState9 } from "react";
+import { Box as Box10, Text as Text10, useInput as useInput10 } from "ink";
+import { jsx as jsx10, jsxs as jsxs10 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState7(true);
-  const [enabled, setEnabled] = useState7(true);
+  const [loading, setLoading] = useState9(true);
+  const [enabled, setEnabled] = useState9(true);
   useEffect7(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
@@ -1012,7 +1257,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput8((input, key) => {
+  useInput10((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -1027,19 +1272,19 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx8(Text8, { children: " " }),
-    loading ? /* @__PURE__ */ jsx8(Text8, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs8(Text8, { children: [
+  return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx10(Text10, { bold: true, children: "Settings \u203A Debug Mode" }),
+    /* @__PURE__ */ jsx10(Text10, { children: " " }),
+    loading ? /* @__PURE__ */ jsx10(Text10, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs10(Text10, { children: [
       "Debug logging:",
       " ",
-      /* @__PURE__ */ jsx8(Text8, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+      /* @__PURE__ */ jsx10(Text10, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
     ] }),
-    /* @__PURE__ */ jsx8(Text8, { children: " " }),
-    /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "[Enter/Space] Toggle [Esc/q] Back to Settings" })
+    /* @__PURE__ */ jsx10(Text10, { children: " " }),
+    /* @__PURE__ */ jsx10(Text10, { dimColor: true, children: "[Enter/Space] Toggle [Esc/q] Back to Settings" })
   ] });
 }
-var init_screen2 = __esm({
+var init_screen4 = __esm({
   "packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx"() {
     "use strict";
     init_home_theme();
@@ -1053,48 +1298,61 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { useState as useState8 } from "react";
-import { jsx as jsx9 } from "react/jsx-runtime";
+import { useState as useState10 } from "react";
+import { jsx as jsx11 } from "react/jsx-runtime";
 function App({ onLaunchImport, importExitCode }) {
   const returnedFromImport = importExitCode !== void 0;
-  const [screen, setScreen] = useState8(returnedFromImport ? "import" : "start");
+  const [screen, setScreen] = useState10(returnedFromImport ? "import" : "start");
+  const [showImportResult, setShowImportResult] = useState10(returnedFromImport);
+  const [projectPath, setProjectPath] = useState10();
   const goToStart = () => setScreen("start");
   const goToSettings = () => setScreen("settings");
-  const navigateFromHome = (next) => {
-    if (next === "import" && onLaunchImport) {
-      onLaunchImport();
-      return;
-    }
-    setScreen(next);
+  const finishImportResult = () => {
+    setShowImportResult(false);
+    setProjectPath(void 0);
+    goToStart();
+  };
+  const leaveImport = () => {
+    setProjectPath(void 0);
+    goToStart();
   };
   switch (screen) {
     case "import":
-      return /* @__PURE__ */ jsx9(ImportScreen, { exitCode: importExitCode, onDone: goToStart });
+      if (showImportResult) return /* @__PURE__ */ jsx11(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (projectPath === void 0) return /* @__PURE__ */ jsx11(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport });
+      return /* @__PURE__ */ jsx11(
+        TokenInputScreen,
+        {
+          onConfirm: (tokens) => onLaunchImport?.({ project: projectPath, tokens }),
+          onSkip: () => onLaunchImport?.({ project: projectPath, skipTokenPrompt: true }),
+          onBack: () => setProjectPath(void 0)
+        }
+      );
     case "help":
-      return /* @__PURE__ */ jsx9(HelpScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx11(HelpScreen, { onDone: goToStart });
     case "upgrade":
-      return /* @__PURE__ */ jsx9(UpgradeScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx11(UpgradeScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx9(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx11(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx9(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx11(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx9(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx11(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx9(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx11(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx9(HomeScreen, { onNavigate: navigateFromHome });
+      return /* @__PURE__ */ jsx11(HomeScreen, { onNavigate: setScreen });
   }
 }
 async function renderUntilImportRequestedOrExit(renderApp, importExitCode) {
-  let importRequested = false;
+  let requestedImport;
   const instance = renderApp(
-    /* @__PURE__ */ jsx9(
+    /* @__PURE__ */ jsx11(
       App,
       {
         importExitCode,
-        onLaunchImport: () => {
-          importRequested = true;
+        onLaunchImport: (options) => {
+          requestedImport = options;
           instance.unmount();
         }
       }
@@ -1102,13 +1360,15 @@ async function renderUntilImportRequestedOrExit(renderApp, importExitCode) {
   );
   await instance.waitUntilExit();
   await stopReadingTerminal();
-  return importRequested;
+  return requestedImport;
 }
 async function runApp(renderApp) {
   let importExitCode;
-  while (await renderUntilImportRequestedOrExit(renderApp, importExitCode)) {
-    importExitCode = (await spawnV1Import({})).exitCode;
+  let requestedImport = await renderUntilImportRequestedOrExit(renderApp, importExitCode);
+  while (requestedImport !== void 0) {
+    importExitCode = (await spawnV1Import(requestedImport)).exitCode;
     startReadingTerminal();
+    requestedImport = await renderUntilImportRequestedOrExit(renderApp, importExitCode);
   }
 }
 var init_app = __esm({
@@ -1116,14 +1376,15 @@ var init_app = __esm({
     "use strict";
     init_home();
     init_PageContainer();
+    init_steps();
     init_spawn_v1_import();
     init_terminal_input();
     init_PageContainer2();
     init_PageContainer3();
     init_ContentfulConfigScreen();
-    init_screen();
+    init_screen3();
     init_PageContainer4();
-    init_screen2();
+    init_screen4();
   }
 });