@contentful/experience-design-system-cli 2.40.1-dev-build-08f065f9.0 → 2.40.1-dev-build-35756f2e.0

package/dist/app.js

@@ -3391,6 +3391,7 @@ function TokenInputScreen({ onConfirm, onBack, initialPath = "" }) {
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx
 import { useEffect as useEffect6, useMemo, useState as useState7 } from "react";
 import { Box as Box12, Text as Text12 } from "ink";
+init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/controls.ts
 import { useInput as useInput9 } from "ink";
@@ -3451,6 +3452,19 @@ function summarize(counts, { hasTokens = true } = {}) {
     warning: hasTokens ? "No component or token files found. Try a different path." : "No component files found. Try a different path."
   };
 }
+function scanReport(scan, path5, { hasTokens = true } = {}) {
+  if (scan === void 0) return { scan: "unfinished" };
+  if (!scan.ok) return { scan: "failed", failure: scan.failure, error: describeFailure(scan.failure, path5).headline };
+  const { total, warning } = summarize(scan.counts, { hasTokens });
+  const { total: _total, ...byType } = scan.counts;
+  return {
+    scan: "ok",
+    files_found: total,
+    counts: Object.fromEntries(Object.entries(byType).filter(([, count]) => count > 0)),
+    ...warning ? { warning } : {},
+    ...scan.warnings.length > 0 ? { scan_warnings: scan.warnings } : {}
+  };
+}
 function phaseOf(scan) {
   if (scan === void 0) return "scanning";
   return scan.ok ? "ready" : "failed";
@@ -18038,6 +18052,7 @@ function Summary({
   ] });
 }
 function PathValidationScreen({
+  mode,
   projectPath,
   onConfirm,
   onChangePath,
@@ -18046,16 +18061,39 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
+  useEffect6(() => {
+    startDebugRun({
+      flow: "import/path-validation",
+      step: "03-path-validation",
+      menuOption: "Path validation",
+      inputs: { import_mode: mode, project_path: projectPath, resolved_path: resolvedPath }
+    });
+  }, []);
   useEffect6(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
+  const finish = (outcome, exitMethod) => {
+    void finishDebugRun({
+      outputs: { outcome, ...scanReport(scan, resolvedPath, { hasTokens }) },
+      status: scan?.ok === false ? "error" : "success",
+      exitMethod
+    });
+  };
   usePathValidationControls(phase, {
     onConfirm: () => {
-      if (scan?.ok) onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
+      if (!scan?.ok) return;
+      finish("continued", "saved");
+      onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
     },
-    onChangePath,
-    onBack
+    onChangePath: () => {
+      finish("changed-path", "discarded");
+      onChangePath();
+    },
+    onBack: () => {
+      finish("back", "discarded");
+      onBack();
+    }
   });
   return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx13(StepHeader, { step: "setup" }),
@@ -31038,6 +31076,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 PathValidationScreen,
                 {
+                  mode: target,
                   projectPath: answers.projectPath ?? "",
                   hasTokens: target !== "components",
                   onConfirm: ({ filePaths }) => answer({ scannedFiles: filePaths }),

package/dist/index.js

@@ -20625,6 +20625,19 @@ function summarize(counts, { hasTokens = true } = {}) {
     warning: hasTokens ? "No component or token files found. Try a different path." : "No component files found. Try a different path."
   };
 }
+function scanReport(scan, path5, { hasTokens = true } = {}) {
+  if (scan === void 0) return { scan: "unfinished" };
+  if (!scan.ok) return { scan: "failed", failure: scan.failure, error: describeFailure(scan.failure, path5).headline };
+  const { total, warning } = summarize(scan.counts, { hasTokens });
+  const { total: _total, ...byType } = scan.counts;
+  return {
+    scan: "ok",
+    files_found: total,
+    counts: Object.fromEntries(Object.entries(byType).filter(([, count]) => count > 0)),
+    ...warning ? { warning } : {},
+    ...scan.warnings.length > 0 ? { scan_warnings: scan.warnings } : {}
+  };
+}
 function phaseOf(scan) {
   if (scan === void 0) return "scanning";
   return scan.ok ? "ready" : "failed";
@@ -20763,6 +20776,7 @@ function Summary({
   ] });
 }
 function PathValidationScreen({
+  mode,
   projectPath,
   onConfirm,
   onChangePath,
@@ -20771,16 +20785,39 @@ function PathValidationScreen({
 }) {
   const resolvedPath = useMemo(() => resolveUserPath(projectPath), [projectPath]);
   const [scan, setScan] = useState7();
+  useEffect6(() => {
+    startDebugRun({
+      flow: "import/path-validation",
+      step: "03-path-validation",
+      menuOption: "Path validation",
+      inputs: { import_mode: mode, project_path: projectPath, resolved_path: resolvedPath }
+    });
+  }, []);
   useEffect6(() => {
     setScan(scanFiles(resolvedPath));
   }, [resolvedPath]);
   const phase = phaseOf(scan);
+  const finish = (outcome, exitMethod) => {
+    void finishDebugRun({
+      outputs: { outcome, ...scanReport(scan, resolvedPath, { hasTokens }) },
+      status: scan?.ok === false ? "error" : "success",
+      exitMethod
+    });
+  };
   usePathValidationControls(phase, {
     onConfirm: () => {
-      if (scan?.ok) onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
+      if (!scan?.ok) return;
+      finish("continued", "saved");
+      onConfirm({ projectPath: resolvedPath, filePaths: scan.filePaths });
+    },
+    onChangePath: () => {
+      finish("changed-path", "discarded");
+      onChangePath();
     },
-    onChangePath,
-    onBack
+    onBack: () => {
+      finish("back", "discarded");
+      onBack();
+    }
   });
   return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx13(StepHeader, { step: "setup" }),
@@ -20800,6 +20837,7 @@ var init_screen4 = __esm({
   "packages/experience-design-system-cli/src/tui/import/steps/03-path-validation/screen.tsx"() {
     "use strict";
     init_theme();
+    init_debug_store();
     init_resolve_user_path();
     init_controls6();
     init_scan_files();
@@ -34855,6 +34893,7 @@ function App({ importOptions, inkClear }) {
               return /* @__PURE__ */ jsx66(
                 PathValidationScreen,
                 {
+                  mode: target,
                   projectPath: answers.projectPath ?? "",
                   hasTokens: target !== "components",
                   onConfirm: ({ filePaths }) => answer({ scannedFiles: filePaths }),

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.40.1-dev-build-08f065f9.0",
+  "version": "2.40.1-dev-build-35756f2e.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

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

@@ -40,6 +40,14 @@ export declare function describeFailure(failure: ScanFailureCode, path: string):
 export declare function summarize(counts: FileCounts, { hasTokens }?: {
     hasTokens?: boolean;
 }): Summary;
+/**
+ * What the debug log says about a scan: the counts and warnings when it worked, or the failure and the message the user
+ * saw when it did not. File paths are left out, since a project can have thousands; the counts are what show whether
+ * the scan found the components.
+ */
+export declare function scanReport(scan: ScanResult | undefined, path: string, { hasTokens }?: {
+    hasTokens?: boolean;
+}): Record<string, unknown>;
 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

@@ -1,5 +1,8 @@
 import React from 'react';
+import type { ImportTarget } from '../00-preflight/logic.js';
 interface PathValidationScreenProps {
+    /** What the user chose to import at Preflight; it decides which steps run, so every log notes it. */
+    mode: ImportTarget;
     projectPath: string;
     onConfirm: (result: {
         projectPath: string;
@@ -10,5 +13,5 @@ interface PathValidationScreenProps {
     /** False when the import does not generate tokens, so `.json` files are not described as design tokens. */
     hasTokens?: boolean;
 }
-export declare function PathValidationScreen({ projectPath, onConfirm, onChangePath, onBack, hasTokens, }: PathValidationScreenProps): React.ReactElement;
+export declare function PathValidationScreen({ mode, projectPath, onConfirm, onChangePath, onBack, hasTokens, }: PathValidationScreenProps): React.ReactElement;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.40.1-dev-build-08f065f9.0",
+  "version": "2.40.1-dev-build-35756f2e.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,7 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-types": "2.40.1-dev-build-08f065f9.0"
+    "@contentful/experience-design-system-types": "2.40.1-dev-build-35756f2e.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
@@ -59,7 +59,7 @@
     "ink-testing-library": "^4.0.0",
     "typescript-eslint": "^8.67.0",
     "vitest": "^4.0.16",
-    "@contentful/experience-design-system-backend-pipeline": "2.40.1-dev-build-08f065f9.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.40.1-dev-build-35756f2e.0"
   },
   "repository": {
     "type": "git",