@contentful/experience-design-system-cli 2.37.1-dev-build-414ce827.0 → 2.37.1-dev-build-e051d273.0

package/dist/app.js

@@ -2116,21 +2116,71 @@ var init_config = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts
+function toRetentionDays(value) {
+  return RETENTION_CHOICES.find((choice) => choice === value) ?? DEFAULT_RETENTION_DAYS;
+}
 async function readDebugModeSetting() {
   const { debugMode } = await readSettings2();
-  return { ...DEFAULT_DEBUG_MODE_SETTING, ...debugMode };
+  const saved = debugMode ?? {};
+  return {
+    enabled: typeof saved.enabled === "boolean" ? saved.enabled : true,
+    retentionDays: toRetentionDays(saved.retentionDays)
+  };
 }
-async function writeDebugModeSetting(setting) {
-  await updateSettings2({ debugMode: setting });
+async function writeDebugModeSetting(change) {
+  await updateSettings2({ debugMode: { ...await readDebugModeSetting(), ...change } });
 }
-var DEFAULT_DEBUG_MODE_SETTING;
+var RETENTION_CHOICES, DEFAULT_RETENTION_DAYS;
 var init_debug_mode_store = __esm({
   "packages/experience-design-system-cli/src/tui/settings/debug-mode/debug-mode-store.ts"() {
     "use strict";
     init_config();
-    DEFAULT_DEBUG_MODE_SETTING = {
-      enabled: true
-    };
+    RETENTION_CHOICES = [30, 60, 90];
+    DEFAULT_RETENTION_DAYS = 30;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/debug-prune.ts
+import { readdir as readdir3, rm, stat as stat5 } from "node:fs/promises";
+import { join as join24 } from "node:path";
+async function logFilesIn(dir) {
+  const entries = await readdir3(dir, { withFileTypes: true });
+  const nested = await Promise.all(
+    entries.map(async (entry) => {
+      const path5 = join24(dir, entry.name);
+      if (entry.isDirectory()) return logFilesIn(path5);
+      return entry.isFile() && entry.name.endsWith(".md") ? [path5] : [];
+    })
+  );
+  return nested.flat();
+}
+async function pruneExpiredLogs(base, retentionDays, now = Date.now()) {
+  const cutoff = now - retentionDays * DAY_MS;
+  const contentfulDir = join24(base, ".contentful");
+  let deleted = 0;
+  try {
+    const sessions = (await readdir3(contentfulDir)).filter((name) => SESSION_FOLDER.test(name));
+    for (const session of sessions) {
+      const files = await logFilesIn(join24(contentfulDir, session, "debug")).catch(() => []);
+      for (const file of files) {
+        try {
+          if ((await stat5(file)).mtimeMs >= cutoff) continue;
+          await rm(file);
+          deleted += 1;
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return deleted;
+}
+var DAY_MS, SESSION_FOLDER;
+var init_debug_prune = __esm({
+  "packages/experience-design-system-cli/src/tui/debug-prune.ts"() {
+    "use strict";
+    DAY_MS = 24 * 60 * 60 * 1e3;
+    SESSION_FOLDER = /^\d{2}-\d{2}-\d{4}-session-\d+$/;
   }
 });
 
@@ -2146,7 +2196,7 @@ __export(debug_store_exports, {
 });
 import { mkdir as mkdir9, writeFile as writeFile8 } from "node:fs/promises";
 import { existsSync as existsSync9, readdirSync as readdirSync4 } from "node:fs";
-import { join as join24, resolve as resolve26 } from "node:path";
+import { join as join25, resolve as resolve26 } from "node:path";
 function generateRunId() {
   const now = /* @__PURE__ */ new Date();
   const pad = (n) => String(n).padStart(2, "0");
@@ -2178,12 +2228,12 @@ function nextSessionId(contentfulDir) {
   return `${today}-session-${maxSeq + 1}`;
 }
 function startSession(base, { replace }) {
-  const contentfulDir = join24(base, ".contentful");
-  if (replace || !sessionDir) sessionDir = join24(contentfulDir, nextSessionId(contentfulDir));
+  const contentfulDir = join25(base, ".contentful");
+  if (replace || !sessionDir) sessionDir = join25(contentfulDir, nextSessionId(contentfulDir));
   return sessionDir;
 }
 function currentDebugSessionDir() {
-  return sessionDir && join24(sessionDir, "debug");
+  return sessionDir && join25(sessionDir, "debug");
 }
 function currentSessionDir() {
   return sessionDir;
@@ -2191,7 +2241,7 @@ function currentSessionDir() {
 async function startDebugSessionIn(base, { replace = false } = {}) {
   try {
     if (!await isDebugModeEnabled()) return;
-    await mkdir9(join24(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
+    await mkdir9(join25(startSession(resolve26(base), { replace }), "debug"), { recursive: true });
   } catch {
   }
 }
@@ -2201,11 +2251,11 @@ function nextImportRunDir(session) {
     const match2 = /^dsi-import-(\d+)$/.exec(entry);
     return match2 ? Math.max(max, Number(match2[1])) : max;
   }, 0);
-  return join24(session, `dsi-import-${maxRun + 1}`);
+  return join25(session, `dsi-import-${maxRun + 1}`);
 }
 async function startImportRun(projectPath) {
   await startDebugSessionIn(projectPath);
-  if (!sessionDir) return join24(resolve26(projectPath), ".contentful");
+  if (!sessionDir) return join25(resolve26(projectPath), ".contentful");
   const dir = nextImportRunDir(sessionDir);
   await mkdir9(dir, { recursive: true });
   return dir;
@@ -2252,10 +2302,10 @@ async function finishDebugRun({
   const root = currentDebugSessionDir();
   if (!root) return;
   const flowSegments = run.flow.split("/");
-  const dir = join24(root, ...flowSegments);
+  const dir = join25(root, ...flowSegments);
   await mkdir9(dir, { recursive: true });
   const filename = nextAttemptFilename(dir, run.menuOption);
-  await writeFile8(join24(dir, filename), content, { mode: 384 });
+  await writeFile8(join25(dir, filename), content, { mode: 384 });
 }
 function nextAttemptFilename(dir, menuOption) {
   const today = datePrefix();
@@ -2306,9 +2356,11 @@ var init_debug_store = __esm({
     init_config();
     init_version();
     init_debug_mode_store();
-    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(([enabled, base]) => {
-      if (!enabled || !base) return void 0;
-      return mkdir9(join24(startSession(base, { replace: false }), "debug"), { recursive: true });
+    init_debug_prune();
+    void Promise.all([isDebugModeEnabled(), readBaseDir()]).then(async ([enabled, base]) => {
+      if (!base) return;
+      await readDebugModeSetting().then(({ retentionDays }) => pruneExpiredLogs(base, retentionDays)).catch(() => void 0);
+      if (enabled) await mkdir9(join25(startSession(base, { replace: false }), "debug"), { recursive: true });
     });
     process.once("uncaughtException", (err) => {
       void handleCrash().finally(() => {
@@ -2329,7 +2381,7 @@ var init_debug_store = __esm({
 });
 
 // packages/experience-design-system-cli/app.tsx
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 import { useEffect as useEffect27, useState as useState36 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
@@ -2586,8 +2638,7 @@ function WelcomeScreen({ onContinue, onQuit, initialPath = "" }) {
     /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", gap: 1, children: [
       /* @__PURE__ */ jsx4(Text4, { children: "Where is your component library?" }),
       /* @__PURE__ */ jsxs3(Box3, { children: [
-        /* @__PURE__ */ jsx4(Text4, { color: PALETTE.text, children: "?" }),
-        /* @__PURE__ */ jsx4(Text4, { children: "Project path:" }),
+        /* @__PURE__ */ jsx4(Text4, { children: "Project path: " }),
         /* @__PURE__ */ jsx4(TextInput, { value: projectPath, onChange: setProjectPath, onSubmit: submit })
       ] })
     ] }),
@@ -8779,8 +8830,8 @@ function getWorkspacePackageDirs(workspaceRoot) {
         continue;
       const entryPath = join7(dir, entry);
       try {
-        const stat5 = statSync3(entryPath);
-        if (stat5.isDirectory()) {
+        const stat6 = statSync3(entryPath);
+        if (stat6.isDirectory()) {
           scanDir(entryPath, depth + 1);
         }
       } catch {
@@ -9648,8 +9699,8 @@ function extractAccessorProperties(classDecl, applyRuntimeFieldDenylist = false)
     accessors.set(name, entry);
   }
   for (const [name, { getter, setter }] of accessors) {
-    const hasPropertyDecorator2 = getter?.getDecorators().some((decorator) => decorator.getName() === "property") || setter?.getDecorators().some((decorator) => decorator.getName() === "property");
-    if (!hasPropertyDecorator2 && !(getter && setter))
+    const hasPropertyDecorator = getter?.getDecorators().some((decorator) => decorator.getName() === "property") || setter?.getDecorators().some((decorator) => decorator.getName() === "property");
+    if (!hasPropertyDecorator && !(getter && setter))
       continue;
     const type = getter?.getReturnTypeNode()?.getText() ?? setter?.getParameters()[0]?.getTypeNode()?.getText() ?? "any";
     const accessorNode = getter ?? setter;
@@ -12867,15 +12918,15 @@ function walkProjectTree(dir, result, includeContent) {
 // packages/experience-design-system-backend-pipeline/dist/src/persistence/src/helpers/collect-files/collect-files.js
 function collectFiles(root, options = {}) {
   const resolved = path4.resolve(root);
-  let stat5;
+  let stat6;
   try {
-    stat5 = statSync4(resolved);
+    stat6 = statSync4(resolved);
   } catch (err) {
     return { ok: false, failure: classifyStatError(err.code), rootPath: resolved };
   }
-  if (stat5.isFile())
+  if (stat6.isFile())
     return { ok: false, failure: "is-file", rootPath: resolved };
-  if (!stat5.isDirectory())
+  if (!stat6.isDirectory())
     return { ok: false, failure: "not-directory", rootPath: resolved };
   const result = {
     filePaths: [],
@@ -12919,9 +12970,9 @@ function generateUlid(now = Date.now()) {
     tsBytes[i] = n & 255;
     n = Math.floor(n / 256);
   }
-  const ts6 = encodeBase32(tsBytes, 10);
+  const ts3 = encodeBase32(tsBytes, 10);
   const rand = encodeBase32(randomBytes2(10), 16);
-  return (ts6 + rand).toUpperCase();
+  return (ts3 + rand).toUpperCase();
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/persistence/src/runs/repositories/read-runs-file.js
@@ -15335,691 +15386,93 @@ async function runMapTokens(request) {
 import { mkdir as mkdir4 } from "node:fs/promises";
 import { relative as relative2 } from "node:path";
 
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/astro/helpers/collect-astro-props-bindings.js
-import { Node as Node10, Project as Project7 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-shared.js
-import { Project as Project8 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-node-utils.js
-import { Node as Node12, SyntaxKind as SyntaxKind7 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/resolve-tsx-workspace-imports.js
-import { Node as Node11 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/resolve-tsx-tsconfig-path.js
-import ts3 from "typescript";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/shared/helpers/tsx-renderable-exports.js
-import { Node as Node13 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/collect-jsx-component-references.js
-import { Node as Node15, SyntaxKind as SyntaxKind9 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/ast/get-jsx-ast-data.js
-import { Node as Node14 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/ast/collect-structural-jsx-evidence.js
-import { SyntaxKind as SyntaxKind8 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-from-react-source-file.js
-import { SyntaxKind as SyntaxKind14 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-component-from-export.js
-import { Node as Node32 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/collect-prop-dataflow.js
-import { Node as Node17, SyntaxKind as SyntaxKind10 } from "ts-morph";
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/quality/non-authorable-filter.js
+var HANDLER_TYPE_PATTERN = /=>|EventHandler|Dispatch<|SetStateAction/;
+var REF_TYPE_PATTERN = /Ref<|RefObject<|MutableRefObject/;
+function isHandlerOrRefProp(prop) {
+  if (HANDLER_TYPE_PATTERN.test(prop.type))
+    return true;
+  if (REF_TYPE_PATTERN.test(prop.type))
+    return true;
+  if (/^on[A-Z]/.test(prop.name) || /^set[A-Z]/.test(prop.name))
+    return true;
+  if (prop.name === "ref" || prop.name === "innerRef")
+    return true;
+  return false;
+}
+function hasNoPropsAndNoSlots(props, slots) {
+  return props.length === 0 && slots.length === 0;
+}
+function isContextProviderWithValueProp(props, usesCreateContext) {
+  return !!usesCreateContext && props.some((p) => p.name === "value");
+}
+function isHardwiredContextProvider(props, usesCreateContext) {
+  return !!usesCreateContext && props.length === 0;
+}
+function isSingleDataPropContextWrapper(props, usesCreateContext) {
+  return !!usesCreateContext && props.length === 1 && !isHandlerOrRefProp(props[0]);
+}
+function hasOnlyEventHandlers(props) {
+  return props.length > 0 && props.every(isHandlerOrRefProp);
+}
+function hasNoAuthoringSurface(component) {
+  const { props, slots, usesCreateContext } = component;
+  if (hasNoPropsAndNoSlots(props, slots))
+    return { skip: true, reason: "component has no props and no slots" };
+  if (isContextProviderWithValueProp(props, usesCreateContext))
+    return {
+      skip: true,
+      reason: "source uses createContext and component exposes a Context.Provider value prop"
+    };
+  if (isHardwiredContextProvider(props, usesCreateContext))
+    return {
+      skip: true,
+      reason: "source uses createContext and component has no props"
+    };
+  if (isSingleDataPropContextWrapper(props, usesCreateContext))
+    return {
+      skip: true,
+      reason: "source uses createContext and component has a single non-handler prop"
+    };
+  if (hasOnlyEventHandlers(props))
+    return { skip: true, reason: "every prop is a handler or ref" };
+  return { skip: false };
+}
 
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/resolve-component-function.js
-import { Node as Node16 } from "ts-morph";
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/evidence/source-inspection.js
+import { readFile as readFile15 } from "node:fs/promises";
 
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-props-from-type.js
-import { Node as Node24 } from "ts-morph";
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/constants/review-reasons.js
+var HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON = "data-fetch-wrapper";
+var POSSIBLE_DATA_FETCH_WRAPPER_REASON = "possible-data-fetch-wrapper";
+var ZERO_SURFACE_RENDERED_UI_REASON = "zero-surface:rendered-ui";
 
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/dom-attribute-surfaces.js
-import { Node as Node18 } from "ts-morph";
-function createTextControlSurface2(onChangeType, specificProps) {
-  return [
-    { name: "autoComplete", type: "string", required: false },
-    ...specificProps,
-    { name: "disabled", type: "boolean", required: false },
-    { name: "name", type: "string", required: false },
-    { name: "onChange", type: onChangeType, required: false },
-    { name: "placeholder", type: "string", required: false },
-    { name: "readOnly", type: "boolean", required: false },
-    { name: "required", type: "boolean", required: false },
-    {
-      name: "value",
-      type: "string | number | readonly string[]",
-      required: false
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/framework-adapters/shared/parse-imported-names.js
+function parseImportedNames(importClause) {
+  const trimmed = importClause.trim();
+  if (!trimmed)
+    return [];
+  const names = [];
+  const defaultAndNamed = trimmed.split(",").map((part) => part.trim());
+  for (const part of defaultAndNamed) {
+    if (!part)
+      continue;
+    if (part.startsWith("{") && part.endsWith("}")) {
+      for (const named of part.slice(1, -1).split(",").map((item) => item.trim()).filter(Boolean)) {
+        const [local2] = named.split(/\s+as\s+/i);
+        if (local2)
+          names.push(local2.trim());
+      }
+      continue;
     }
-  ];
+    const [local] = part.split(/\s+as\s+/i);
+    if (local)
+      names.push(local.trim());
+  }
+  return names;
 }
-var DOM_ATTRIBUTE_PROP_SURFACES2 = {
-  HTMLProps: [],
-  HTMLAttributes: [
-    { name: "className", type: "string", required: false },
-    { name: "hidden", type: "boolean", required: false },
-    { name: "id", type: "string", required: false },
-    {
-      name: "onClick",
-      type: "MouseEventHandler<HTMLElement>",
-      required: false
-    },
-    { name: "style", type: "CSSProperties", required: false },
-    { name: "tabIndex", type: "number", required: false },
-    { name: "title", type: "string", required: false }
-  ],
-  ImgHTMLAttributes: [
-    { name: "alt", type: "string", required: false },
-    { name: "crossOrigin", type: "string", required: false },
-    { name: "height", type: "number | string", required: false },
-    {
-      name: "loading",
-      type: "string",
-      required: false,
-      allowedValues: ["eager", "lazy"]
-    },
-    { name: "sizes", type: "string", required: false },
-    { name: "src", type: "string", required: false },
-    { name: "srcSet", type: "string", required: false },
-    { name: "width", type: "number | string", required: false }
-  ],
-  LiHTMLAttributes: [],
-  AnchorHTMLAttributes: [
-    { name: "download", type: "boolean | string", required: false },
-    { name: "href", type: "string", required: false },
-    { name: "hrefLang", type: "string", required: false },
-    { name: "referrerPolicy", type: "string", required: false },
-    { name: "rel", type: "string", required: false },
-    {
-      name: "target",
-      type: "string",
-      required: false,
-      allowedValues: ["_blank", "_parent", "_self", "_top"]
-    }
-  ],
-  ButtonHTMLAttributes: [
-    { name: "autoFocus", type: "boolean", required: false },
-    { name: "disabled", type: "boolean", required: false },
-    { name: "form", type: "string", required: false },
-    { name: "formAction", type: "string", required: false },
-    { name: "formMethod", type: "string", required: false },
-    { name: "formNoValidate", type: "boolean", required: false },
-    { name: "formTarget", type: "string", required: false },
-    { name: "name", type: "string", required: false },
-    {
-      name: "type",
-      type: "string",
-      required: false,
-      allowedValues: ["button", "reset", "submit"]
-    },
-    {
-      name: "value",
-      type: "string | number | readonly string[]",
-      required: false
-    }
-  ],
-  InputHTMLAttributes: createTextControlSurface2("ChangeEventHandler<HTMLInputElement>", [
-    { name: "checked", type: "boolean", required: false },
-    { name: "max", type: "number | string", required: false },
-    { name: "maxLength", type: "number", required: false },
-    { name: "min", type: "number | string", required: false },
-    { name: "minLength", type: "number", required: false },
-    { name: "type", type: "string", required: false }
-  ]),
-  FieldsetHTMLAttributes: [
-    { name: "disabled", type: "boolean", required: false },
-    { name: "form", type: "string", required: false },
-    { name: "name", type: "string", required: false }
-  ],
-  LabelHTMLAttributes: [
-    { name: "form", type: "string", required: false },
-    { name: "htmlFor", type: "string", required: false }
-  ],
-  SelectHTMLAttributes: [
-    { name: "autoComplete", type: "string", required: false },
-    { name: "disabled", type: "boolean", required: false },
-    { name: "form", type: "string", required: false },
-    { name: "multiple", type: "boolean", required: false },
-    { name: "name", type: "string", required: false },
-    {
-      name: "onChange",
-      type: "ChangeEventHandler<HTMLSelectElement>",
-      required: false
-    },
-    { name: "required", type: "boolean", required: false },
-    { name: "size", type: "number", required: false },
-    {
-      name: "value",
-      type: "string | number | readonly string[]",
-      required: false
-    }
-  ],
-  SVGAttributes: [
-    {
-      name: "focusable",
-      type: 'boolean | "auto"',
-      required: false,
-      allowedValues: ["auto"]
-    },
-    { name: "height", type: "number | string", required: false },
-    { name: "viewBox", type: "string", required: false },
-    { name: "width", type: "number | string", required: false }
-  ],
-  SVGProps: [],
-  TextareaHTMLAttributes: createTextControlSurface2("ChangeEventHandler<HTMLTextAreaElement>", [
-    { name: "cols", type: "number", required: false },
-    { name: "rows", type: "number", required: false },
-    { name: "wrap", type: "string", required: false }
-  ]),
-  TdHTMLAttributes: [
-    {
-      name: "align",
-      type: "string",
-      required: false,
-      allowedValues: ["center", "char", "justify", "left", "right"]
-    },
-    { name: "colSpan", type: "number", required: false },
-    { name: "headers", type: "string", required: false },
-    { name: "rowSpan", type: "number", required: false },
-    { name: "scope", type: "string", required: false }
-  ]
-};
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/collect-dom-wrapper-contexts.js
-import { Node as Node19 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-dom-is-pure-wrapper.js
-import { Node as Node20 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-omit-wrapped-custom-props.js
-import { Node as Node21 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-pick-type-patterns.js
-import { Node as Node22 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/detect-react-polymorphic.js
-import { Node as Node23 } from "ts-morph";
 
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/resolve-react-props-type.js
-import { Node as Node25 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-binding-defaults.js
-import { Node as Node28 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/filter-impl-alias-props.js
-import { Node as Node26 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-binding-fallback-props.js
-import { Node as Node27, SyntaxKind as SyntaxKind11 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/collect-react-impl-hints.js
-import { Node as Node30, SyntaxKind as SyntaxKind13 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/infer-primitive-dom-props.js
-import { Node as Node29, SyntaxKind as SyntaxKind12 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/react/helpers/extract-react-prop-types.js
-import { Node as Node31 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/extractor.js
-import { Project as Project9, Node as Node37 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/detect-stencil-class.js
-import { Node as Node33 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/extract-stencil-props.js
-import { Node as Node35 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/stencil-prop-helpers.js
-import { Node as Node34, SyntaxKind as SyntaxKind15 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/stencil/helpers/extract-stencil-slots.js
-import { Node as Node36 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/resolve-svelte-unresolved-retry.js
-import { Project as Project12, ScriptTarget as ScriptTarget4, ModuleKind as ModuleKind4, ts as ts5 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/scoring/collect-scoring-inputs.js
-var OPAQUE_TYPES2 = /* @__PURE__ */ new Set(["any", "unknown", "object", "Record<string, unknown>", "Record<string, any>"]);
-var OBVIOUS_PROP_NAMES2 = /* @__PURE__ */ new Set([
-  "className",
-  "style",
-  "id",
-  "children",
-  "disabled",
-  "hidden",
-  "onClick",
-  "onChange",
-  "onSubmit",
-  "onBlur",
-  "onFocus",
-  "href",
-  "src",
-  "alt",
-  "type",
-  "value",
-  "checked",
-  "placeholder",
-  "label",
-  "title",
-  "name",
-  "required",
-  "readOnly",
-  "autoFocus",
-  "tabIndex",
-  "role",
-  "aria-label",
-  "aria-describedby"
-]);
-function isWidePrimitiveUnion2(type) {
-  const parts = type.split("|").map((p) => p.trim());
-  if (parts.length < 3)
-    return false;
-  const basePrimitives = /* @__PURE__ */ new Set(["string", "number", "boolean"]);
-  const nullability = /* @__PURE__ */ new Set(["null", "undefined"]);
-  const baseCount = parts.filter((p) => basePrimitives.has(p)).length;
-  const nullabilityCount = parts.filter((p) => nullability.has(p)).length;
-  return baseCount >= 3 || baseCount >= 2 && nullabilityCount > 0 && baseCount + nullabilityCount >= 3;
-}
-function countExtractionIssues(component, options = {}) {
-  let count = 0;
-  const reasons = [];
-  if (component.props.length === 0 && component.slots.length === 0) {
-    count++;
-    reasons.push("no-props-or-slots");
-  }
-  if (component.props.length > 50) {
-    count++;
-    reasons.push(`high-prop-count:${component.props.length}`);
-  }
-  for (const prop of component.props) {
-    if (OPAQUE_TYPES2.has(prop.type.trim())) {
-      count++;
-      reasons.push(`opaque-type:${prop.name}`);
-      break;
-    }
-    if (isWidePrimitiveUnion2(prop.type)) {
-      count++;
-      reasons.push(`wide-union:${prop.name}`);
-      break;
-    }
-    if (!prop.description && !OBVIOUS_PROP_NAMES2.has(prop.name)) {
-      count++;
-      reasons.push("props-missing-description");
-      break;
-    }
-  }
-  count += options.additionalIssueCount ?? 0;
-  if (options.additionalReasons && options.additionalReasons.length > 0) {
-    reasons.push(...options.additionalReasons);
-  }
-  return { count, reasons: [...new Set(reasons)] };
-}
-function mapIssueCountToConfidence(count) {
-  if (count === 0)
-    return 5;
-  if (count === 1)
-    return 4;
-  if (count === 2)
-    return 3;
-  if (count === 3)
-    return 2;
-  return 1;
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/scoring/compute-extraction-score.js
-function computeExtractionScore2(component, options = {}) {
-  const { count, reasons } = countExtractionIssues(component, options);
-  return {
-    confidence: mapIssueCountToConfidence(count),
-    reasons
-  };
-}
-function deriveNeedsReview2(confidence) {
-  return confidence <= 2;
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/resolve-svelte-type-checker.js
-import { Project as Project10, ScriptTarget as ScriptTarget2, ModuleKind as ModuleKind2, ts as ts4 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/extract-svelte-declaration-data.js
-import { Node as Node38 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/resolve-svelte-external-type-readers.js
-import { Node as Node40, Project as Project11, ScriptTarget as ScriptTarget3, ModuleKind as ModuleKind3 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/extract-svelte-external-type-members.js
-import { Node as Node39 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/svelte/helpers/extract-from-svelte-file.js
-import { parse as parseSvelte2 } from "svelte/compiler";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/extractor.js
-import { Node as Node44 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/helpers/extract-vue-tsx-props.js
-import { Node as Node42 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/helpers/resolve-ast-object.js
-import { Node as Node41, SyntaxKind as SyntaxKind16 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue-tsx/helpers/extract-vue-tsx-slots.js
-import { Node as Node43, SyntaxKind as SyntaxKind17 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/extractor.js
-import { parse as parseSFC3 } from "@vue/compiler-sfc";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-setup-props.js
-import { Project as Project14, Node as Node47 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-setup-object-props.js
-import { Project as Project13, Node as Node46 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-object-props.js
-import { Node as Node45 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/vue/helpers/extract-vue-options-props.js
-import { parse as parseSFC2 } from "@vue/compiler-sfc";
-import { Node as Node48, Project as Project15 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/extractor.js
-import { Project as Project16 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/extract-wc-observed-attrs.js
-import { Node as Node49 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/extract-wc-class-properties.js
-import { Node as Node50 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-decorator-tag.js
-import { Node as Node51 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-sibling-definition.js
-import { Node as Node54, SyntaxKind as SyntaxKind19 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import.js
-import { Node as Node53, SyntaxKind as SyntaxKind18 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import-source.js
-import { Node as Node52 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/extract-wc-template-content.js
-import { Node as Node56 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/collect-wc-html-templates.js
-import { Node as Node55 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-base-class.js
-import { Node as Node57, SyntaxKind as SyntaxKind20 } from "ts-morph";
-
-// packages/experience-design-system-extraction/dist/src/extract/services/classification/helpers/check-prop-types.js
-function isStringLiteralUnion(type) {
-  return type.includes("|") && type.includes("'");
-}
-function isSimpleType(type) {
-  const t = type.trim();
-  if (t === "string" || t === "boolean" || t === "number")
-    return true;
-  return isStringLiteralUnion(t);
-}
-function isBooleanType(type) {
-  return type.trim() === "boolean";
-}
-function isStringType(type) {
-  return type.trim() === "string";
-}
-function isNumberType(type) {
-  return type.trim() === "number";
-}
-function isComplexType(type) {
-  return !isSimpleType(type);
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/classification/helpers/detect-dom-props.js
-var DOM_PASS_THROUGH_PROPS = /* @__PURE__ */ new Set([
-  // Bare HTML / framework styling pass-through
-  "className",
-  "class",
-  "classes",
-  "classNames",
-  "rootClassName",
-  "prefixCls",
-  "style",
-  "styles",
-  // Bare HTML attributes
-  "id",
-  "role",
-  "tabIndex",
-  "tabindex",
-  "htmlFor",
-  "for",
-  "slot",
-  "is",
-  "lang",
-  "dir",
-  "hidden",
-  "draggable",
-  "spellCheck",
-  "spellcheck",
-  "contentEditable",
-  "contenteditable",
-  "inputMode",
-  "inputmode",
-  "autoComplete",
-  "autocomplete",
-  "autoFocus",
-  "autofocus",
-  "translate",
-  "part",
-  "exportparts",
-  "aria",
-  // Framework theming / pass-through escape hatches — dev-facing, never marketer-configurable
-  "dt",
-  "pt",
-  "ptOptions",
-  "unstyled",
-  "sx",
-  // Polymorphic component props — change rendered HTML/component, not marketer-visible behavior
-  "as",
-  "element",
-  "component",
-  // QA / vendor test attributes
-  "dataQa",
-  "data-qa",
-  // Vue v-model internals — framework wiring, never marketer-configurable
-  "modelValue",
-  "modelModifiers"
-]);
-function isDomPassThroughProp(name) {
-  if (DOM_PASS_THROUGH_PROPS.has(name))
-    return true;
-  if (/^aria[-A-Z]/.test(name))
-    return true;
-  return name.startsWith("data-");
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/classification/classify-component-props.js
-function preClassifyProp(prop) {
-  const { name, type } = prop;
-  if (/^on[A-Z]/.test(name) || type.includes("=> void") || type.includes("EventHandler")) {
-    return { category: "exclude" };
-  }
-  if (name === "ref" || name === "innerRef" || type.includes("Ref<") || type.includes("RefObject<")) {
-    return { category: "exclude" };
-  }
-  if (name === "testId" || name === "data-testid" || name === "dataTestId") {
-    return { category: "exclude" };
-  }
-  if (name === "key") {
-    return { category: "exclude" };
-  }
-  if (type.includes("Dispatch<") || type.includes("SetStateAction")) {
-    return { category: "exclude" };
-  }
-  if (isDomPassThroughProp(name)) {
-    return { category: "exclude" };
-  }
-  if (name === "name" && prop.domAttribute) {
-    return { category: "exclude" };
-  }
-  if (isStringLiteralUnion(type)) {
-    return { category: "design", cdfTypeHint: "enum" };
-  }
-  if (!isComplexType(type)) {
-    const designNameStart = /^(variant|size|spacing|gap|color|bg|theme|align|layout|orientation|position)/i;
-    const designNameEnd = /(Color|Size|Variant|Style)$/;
-    if (designNameStart.test(name) || designNameEnd.test(name)) {
-      return { category: "design", cdfTypeHint: "string" };
-    }
-  }
-  if (isBooleanType(type)) {
-    const stateNames = ["disabled", "loading", "expanded", "isOpen", "selected", "checked", "active", "preview"];
-    if (stateNames.includes(name)) {
-      return { category: "state", cdfTypeHint: "boolean" };
-    }
-  }
-  if (isBooleanType(type)) {
-    const visualToggle = /^(hide|show|enable|disable|vertical|horizontal|reverse|bold|italic|imageOn|with)/i;
-    if (visualToggle.test(name)) {
-      return { category: "design", cdfTypeHint: "boolean" };
-    }
-  }
-  if (name === "componentId" || name === "sectionKey" || name === "locale" || name === "variantIndex") {
-    return { category: "state", cdfTypeHint: "string" };
-  }
-  if (isStringType(type)) {
-    const urlNameStart = /^(href|url|link|src)/i;
-    const urlNameEnd = /(Url|Href|Link|Src)$/;
-    if (urlNameStart.test(name) || urlNameEnd.test(name)) {
-      return { category: "content", cdfTypeHint: "string" };
-    }
-  }
-  if (isStringType(type)) {
-    const textNameStart = /^(label|title|text|description|caption|heading|subheading|body|alt|name|placeholder|summary)/i;
-    const textNameEnd = /(Text|Label|Title|Name)$/;
-    if (textNameStart.test(name) || textNameEnd.test(name)) {
-      return { category: "content", cdfTypeHint: "string" };
-    }
-  }
-  if (isStringType(type)) {
-    return { category: "content", cdfTypeHint: "string" };
-  }
-  if (isBooleanType(type)) {
-    return { category: "design", cdfTypeHint: "boolean" };
-  }
-  if (isNumberType(type)) {
-    return { category: "design", cdfTypeHint: "string" };
-  }
-  return void 0;
-}
-function preClassifyComponent(component) {
-  const props = component.props.flatMap((prop) => {
-    const result = preClassifyProp(prop);
-    if (result?.category === "exclude") {
-      return [];
-    }
-    const { domAttribute: _domAttribute, ...authorableProp } = prop;
-    if (prop.category) {
-      return [authorableProp];
-    }
-    if (!result) {
-      return [authorableProp];
-    }
-    return [
-      {
-        ...authorableProp,
-        category: result.category
-      }
-    ];
-  });
-  return { ...component, props };
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/authorability/evaluate-authorability.js
-var HANDLER_TYPE_PATTERN = /=>|EventHandler|Dispatch<|SetStateAction/;
-var REF_TYPE_PATTERN = /Ref<|RefObject<|MutableRefObject/;
-function isHandlerOrRefProp(prop) {
-  if (HANDLER_TYPE_PATTERN.test(prop.type))
-    return true;
-  if (REF_TYPE_PATTERN.test(prop.type))
-    return true;
-  if (/^on[A-Z]/.test(prop.name) || /^set[A-Z]/.test(prop.name))
-    return true;
-  if (prop.name === "ref" || prop.name === "innerRef")
-    return true;
-  return false;
-}
-function hasNoPropsAndNoSlots(props, slots) {
-  return props.length === 0 && slots.length === 0;
-}
-function isContextProviderWithValueProp(props, usesCreateContext) {
-  return !!usesCreateContext && props.some((p) => p.name === "value");
-}
-function isHardwiredContextProvider(props, usesCreateContext) {
-  return !!usesCreateContext && props.length === 0;
-}
-function isSingleDataPropContextWrapper(props, usesCreateContext) {
-  return !!usesCreateContext && props.length === 1 && !isHandlerOrRefProp(props[0]);
-}
-function hasOnlyEventHandlers(props) {
-  return props.length > 0 && props.every(isHandlerOrRefProp);
-}
-function hasNoAuthoringSurface(component) {
-  const { props, slots, usesCreateContext } = component;
-  if (hasNoPropsAndNoSlots(props, slots))
-    return { skip: true, reason: "component has no props and no slots" };
-  if (isContextProviderWithValueProp(props, usesCreateContext))
-    return {
-      skip: true,
-      reason: "source uses createContext and component exposes a Context.Provider value prop"
-    };
-  if (isHardwiredContextProvider(props, usesCreateContext))
-    return {
-      skip: true,
-      reason: "source uses createContext and component has no props"
-    };
-  if (isSingleDataPropContextWrapper(props, usesCreateContext))
-    return {
-      skip: true,
-      reason: "source uses createContext and component has a single non-handler prop"
-    };
-  if (hasOnlyEventHandlers(props))
-    return { skip: true, reason: "every prop is a handler or ref" };
-  return { skip: false };
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/inspect-component-source.js
-import { readFile as readFile15 } from "node:fs/promises";
-
-// packages/experience-design-system-extraction/dist/src/extract/helpers/evidence/parse-source-imports.js
-function parseImportedNames(importClause) {
-  const trimmed = importClause.trim();
-  if (!trimmed)
-    return [];
-  const names = [];
-  const defaultAndNamed = trimmed.split(",").map((part) => part.trim());
-  for (const part of defaultAndNamed) {
-    if (!part)
-      continue;
-    if (part.startsWith("{") && part.endsWith("}")) {
-      for (const named of part.slice(1, -1).split(",").map((item) => item.trim()).filter(Boolean)) {
-        const [local2] = named.split(/\s+as\s+/i);
-        if (local2)
-          names.push(local2.trim());
-      }
-      continue;
-    }
-    const [local] = part.split(/\s+as\s+/i);
-    if (local)
-      names.push(local.trim());
-  }
-  return names;
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/detect-data-wrapper-patterns.js
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/evidence/source-inspection.js
 var INFRA_PROP_NAMES = /* @__PURE__ */ new Set(["id", "locale", "preview", "slug", "topic", "previousComponent", "__typename"]);
 var VISIBLE_UI_TAG_PATTERN = /<(?:[A-Z][A-Za-z0-9_.]*|div|span|section|main|article|header|footer|nav|aside|img|video|p|h[1-6]|ul|ol|li|button|input|textarea|select|form|label|table|tbody|thead|tr|td|th)\b/;
 var GENERATED_IMPORT_PATTERN = /from\s+['"][^'"]*__generated[^'"]*['"]/;
@@ -16061,11 +15514,11 @@ function hasSiblingForwardRender(sourceText, siblingImports) {
 function hasVisibleUiRender(sourceText) {
   return /return\s*(?:\(|<)/.test(sourceText) && VISIBLE_UI_TAG_PATTERN.test(sourceText);
 }
-function collectInfraPropNames(component) {
+function infraPropNames(component) {
   const props = component.props.map((prop) => prop.name);
   return props.length > 0 && props.every((prop) => INFRA_PROP_NAMES.has(prop)) ? props : [];
 }
-function mapScoreToWrapperConfidence(score) {
+function scoreToConfidence(score) {
   if (score <= 0)
     return 0;
   if (score <= 2)
@@ -16076,14 +15529,9 @@ function mapScoreToWrapperConfidence(score) {
     return 4;
   return 5;
 }
-function dedupeStrings(values) {
-  return [...new Set(values)];
+function dedupeReasons(reasons) {
+  return [...new Set(reasons)];
 }
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/inspect-component-source.js
-var HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON = "data-fetch-wrapper";
-var POSSIBLE_DATA_FETCH_WRAPPER_REASON = "possible-data-fetch-wrapper";
-var ZERO_SURFACE_RENDERED_UI_REASON = "zero-surface:rendered-ui";
 async function inspectComponentSource(component) {
   let sourceText = "";
   try {
@@ -16098,7 +15546,7 @@ async function inspectComponentSource(component) {
   const reviewReasons = [];
   let wrapperScore = 0;
   const hasGeneratedQueryHook = GENERATED_IMPORT_PATTERN.test(sourceText) && GENERATED_QUERY_HOOK_PATTERN.test(sourceText);
-  const infraProps = collectInfraPropNames(component);
+  const infraProps = infraPropNames(component);
   const siblingImports = collectSiblingRendererImports(sourceText);
   if (GQL_FILENAME_PATTERN.test(component.source)) {
     reviewReasons.push("data-wrapper:gql-filename");
@@ -16112,136 +15560,69 @@ async function inspectComponentSource(component) {
     reviewReasons.push("data-wrapper:sibling-renderer-import");
     wrapperScore += 1;
   }
-  if (hasSiblingForwardRender(sourceText, siblingImports)) {
-    reviewReasons.push("data-wrapper:fetch-forward-render");
-    wrapperScore += 3;
-  }
-  if (sourceText.includes("useContentfulLiveUpdates(") || sourceText.includes("useContentfulContext(")) {
-    reviewReasons.push("data-wrapper:contentful-runtime");
-    wrapperScore += 1;
-  }
-  if (infraProps.length > 0) {
-    reviewReasons.push("data-wrapper:infra-props");
-    wrapperScore += 2;
-  }
-  if (LOADING_NULL_GUARD_PATTERN.test(sourceText)) {
-    reviewReasons.push("data-wrapper:loading-null-guard");
-    wrapperScore += 1;
-  }
-  const wrapperConfidence = mapScoreToWrapperConfidence(wrapperScore);
-  if (wrapperConfidence >= 4) {
-    reviewReasons.unshift(HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON);
-  } else if (wrapperConfidence === 3) {
-    reviewReasons.unshift(POSSIBLE_DATA_FETCH_WRAPPER_REASON);
-  }
-  const keepDespiteZeroSurface = component.props.length === 0 && component.slots.length === 0 && hasVisibleUiRender(sourceText);
-  if (keepDespiteZeroSurface) {
-    reviewReasons.push(ZERO_SURFACE_RENDERED_UI_REASON);
-  }
-  return {
-    wrapperConfidence,
-    reviewReasons: dedupeStrings(reviewReasons),
-    keepDespiteZeroSurface
-  };
-}
-function describeReviewReason(reason) {
-  switch (reason) {
-    case HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON:
-      return "high-confidence data-fetch wrapper";
-    case POSSIBLE_DATA_FETCH_WRAPPER_REASON:
-      return "possible data-fetch wrapper";
-    case "data-wrapper:gql-filename":
-      return "source file follows a gql wrapper naming pattern";
-    case "data-wrapper:generated-query-hook":
-      return "imports and calls a generated query hook";
-    case "data-wrapper:sibling-renderer-import":
-      return "imports a sibling renderer from the same folder";
-    case "data-wrapper:fetch-forward-render":
-      return "forwards fetched data into a sibling renderer";
-    case "data-wrapper:contentful-runtime":
-      return "uses Contentful runtime hooks";
-    case "data-wrapper:infra-props":
-      return "only exposes infra-fetch props";
-    case "data-wrapper:loading-null-guard":
-      return "returns early while loading or when fetched data is missing";
-    case ZERO_SURFACE_RENDERED_UI_REASON:
-      return "source renders visible/compositional UI despite zero extracted props and slots";
-    default:
-      return reason;
-  }
-}
-function describeReviewReasons(reasons) {
-  return dedupeStrings(reasons.map(describeReviewReason));
-}
-
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/helpers/inspection/validate-extracted-components.js
-function validateExtractedComponents2(components) {
-  const nameCounts = /* @__PURE__ */ new Map();
-  for (const component of components) {
-    const key = component.name.trim();
-    nameCounts.set(key, (nameCounts.get(key) ?? 0) + 1);
-  }
-  return components.map((component) => {
-    const issues = [];
-    if (!component.name.trim()) {
-      issues.push({
-        severity: "error",
-        code: "EMPTY_COMPONENT_NAME",
-        message: "Component name must not be empty"
-      });
-    }
-    for (let i = 0; i < component.props.length; i++) {
-      if (!component.props[i].name.trim()) {
-        issues.push({
-          severity: "error",
-          code: "EMPTY_PROP_NAME",
-          message: `Prop at index ${i} has an empty name`,
-          field: `props[${i}].name`
-        });
-      }
-    }
-    for (let i = 0; i < component.slots.length; i++) {
-      if (!component.slots[i].name.trim()) {
-        issues.push({
-          severity: "warning",
-          code: "EMPTY_SLOT_NAME",
-          message: `Slot at index ${i} has an empty name`,
-          field: `slots[${i}].name`
-        });
-      }
-    }
-    const propNames = new Set(component.props.map((p) => p.name.trim()).filter(Boolean));
-    for (let i = 0; i < component.slots.length; i++) {
-      const slotName = component.slots[i].name.trim();
-      if (slotName && propNames.has(slotName)) {
-        issues.push({
-          severity: "error",
-          code: "PROP_SLOT_NAME_COLLISION",
-          message: `"${slotName}" is used as both a prop name and a slot name`,
-          field: `slots[${i}].name`
-        });
-      }
-    }
-    const nameKey = component.name.trim();
-    if (nameKey && (nameCounts.get(nameKey) ?? 0) > 1) {
-      issues.push({
-        severity: "error",
-        code: "DUPLICATE_COMPONENT_NAME",
-        message: `Component name "${component.name}" appears more than once in the extracted set`
-      });
-    }
-    if (component.props.length === 0 && component.slots.length === 0) {
-      issues.push({
-        severity: "warning",
-        code: "EMPTY_COMPONENT",
-        message: "Component has no props or slots and will be filtered out during generation"
-      });
-    }
-    return { ...component, validationIssues: issues };
-  });
+  if (hasSiblingForwardRender(sourceText, siblingImports)) {
+    reviewReasons.push("data-wrapper:fetch-forward-render");
+    wrapperScore += 3;
+  }
+  if (sourceText.includes("useContentfulLiveUpdates(") || sourceText.includes("useContentfulContext(")) {
+    reviewReasons.push("data-wrapper:contentful-runtime");
+    wrapperScore += 1;
+  }
+  if (infraProps.length > 0) {
+    reviewReasons.push("data-wrapper:infra-props");
+    wrapperScore += 2;
+  }
+  if (LOADING_NULL_GUARD_PATTERN.test(sourceText)) {
+    reviewReasons.push("data-wrapper:loading-null-guard");
+    wrapperScore += 1;
+  }
+  const wrapperConfidence = scoreToConfidence(wrapperScore);
+  if (wrapperConfidence >= 4) {
+    reviewReasons.unshift(HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON);
+  } else if (wrapperConfidence === 3) {
+    reviewReasons.unshift(POSSIBLE_DATA_FETCH_WRAPPER_REASON);
+  }
+  const keepDespiteZeroSurface = component.props.length === 0 && component.slots.length === 0 && hasVisibleUiRender(sourceText);
+  if (keepDespiteZeroSurface) {
+    reviewReasons.push(ZERO_SURFACE_RENDERED_UI_REASON);
+  }
+  return {
+    wrapperConfidence,
+    reviewReasons: dedupeReasons(reviewReasons),
+    keepDespiteZeroSurface
+  };
+}
+function describeReviewReason(reason) {
+  switch (reason) {
+    case HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON:
+      return "high-confidence data-fetch wrapper";
+    case POSSIBLE_DATA_FETCH_WRAPPER_REASON:
+      return "possible data-fetch wrapper";
+    case "data-wrapper:gql-filename":
+      return "source file follows a gql wrapper naming pattern";
+    case "data-wrapper:generated-query-hook":
+      return "imports and calls a generated query hook";
+    case "data-wrapper:sibling-renderer-import":
+      return "imports a sibling renderer from the same folder";
+    case "data-wrapper:fetch-forward-render":
+      return "forwards fetched data into a sibling renderer";
+    case "data-wrapper:contentful-runtime":
+      return "uses Contentful runtime hooks";
+    case "data-wrapper:infra-props":
+      return "only exposes infra-fetch props";
+    case "data-wrapper:loading-null-guard":
+      return "returns early while loading or when fetched data is missing";
+    case ZERO_SURFACE_RENDERED_UI_REASON:
+      return "source renders visible/compositional UI despite zero extracted props and slots";
+    default:
+      return reason;
+  }
+}
+function describeReviewReasons(reasons) {
+  return dedupeReasons(reasons.map(describeReviewReason));
 }
 
-// packages/experience-design-system-extraction/dist/src/extract/services/quality/evaluate-extraction-quality.js
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/quality/evaluate-extraction-quality.js
 function wrapperConfidenceToIssueCount(confidence) {
   if (confidence >= 4)
     return 2;
@@ -16273,7 +15654,7 @@ async function evaluateExtractionQuality(components, initialWarnings = []) {
     }
     const extractorReasons = component.reviewReasons ?? [];
     const nonAuthorableReason = retainedForReview ? [`non-authorable:${verdict.reason}`] : [];
-    const { confidence, reasons } = computeExtractionScore2(component, {
+    const { confidence, reasons } = computeExtractionScore(component, {
       additionalIssueCount: wrapperConfidenceToIssueCount(inspection.wrapperConfidence) + extractorReasons.length + nonAuthorableReason.length,
       additionalReasons: [...extractorReasons, ...inspection.reviewReasons, ...nonAuthorableReason]
     });
@@ -16281,15 +15662,194 @@ async function evaluateExtractionQuality(components, initialWarnings = []) {
       ...component,
       extractionConfidence: confidence,
       reviewReasons: reasons,
-      needsReview: deriveNeedsReview2(confidence) || inspection.wrapperConfidence >= 4 || inspection.keepDespiteZeroSurface || retainedForReview || extractorReasons.includes("props-type-unresolved") || (component.needsReview ?? false)
+      needsReview: deriveNeedsReview(confidence) || inspection.wrapperConfidence >= 4 || inspection.keepDespiteZeroSurface || retainedForReview || extractorReasons.includes("props-type-unresolved") || (component.needsReview ?? false)
     });
   }
   return {
-    components: validateExtractedComponents2(scoredComponents),
+    components: validateExtractedComponents(scoredComponents),
     warnings
   };
 }
 
+// packages/experience-design-system-backend-pipeline/dist/src/steps/extraction/src/helpers/pre-classify.js
+function isStringLiteralUnion(type) {
+  return type.includes("|") && type.includes("'");
+}
+function isSimpleType(type) {
+  const t = type.trim();
+  if (t === "string" || t === "boolean" || t === "number")
+    return true;
+  return isStringLiteralUnion(t);
+}
+function isBooleanType(type) {
+  return type.trim() === "boolean";
+}
+function isStringType(type) {
+  return type.trim() === "string";
+}
+function isNumberType(type) {
+  return type.trim() === "number";
+}
+function isComplexType(type) {
+  return !isSimpleType(type);
+}
+var DOM_PASS_THROUGH_PROPS = /* @__PURE__ */ new Set([
+  // Bare HTML / framework styling pass-through
+  "className",
+  "class",
+  "classes",
+  "classNames",
+  "rootClassName",
+  "prefixCls",
+  "style",
+  "styles",
+  // Bare HTML attributes
+  "id",
+  "role",
+  "tabIndex",
+  "tabindex",
+  "htmlFor",
+  "for",
+  "slot",
+  "is",
+  "lang",
+  "dir",
+  "hidden",
+  "draggable",
+  "spellCheck",
+  "spellcheck",
+  "contentEditable",
+  "contenteditable",
+  "inputMode",
+  "inputmode",
+  "autoComplete",
+  "autocomplete",
+  "autoFocus",
+  "autofocus",
+  "translate",
+  "part",
+  "exportparts",
+  "aria",
+  // Framework theming / pass-through escape hatches — dev-facing, never marketer-configurable
+  "dt",
+  "pt",
+  "ptOptions",
+  "unstyled",
+  "sx",
+  // Polymorphic component props — change rendered HTML/component, not marketer-visible behavior
+  "as",
+  "element",
+  "component",
+  // QA / vendor test attributes
+  "dataQa",
+  "data-qa",
+  // Vue v-model internals — framework wiring, never marketer-configurable
+  "modelValue",
+  "modelModifiers"
+]);
+function isDomPassThroughProp(name) {
+  if (DOM_PASS_THROUGH_PROPS.has(name))
+    return true;
+  if (/^aria[-A-Z]/.test(name))
+    return true;
+  return name.startsWith("data-");
+}
+function preClassifyProp(prop) {
+  const { name, type } = prop;
+  if (/^on[A-Z]/.test(name) || type.includes("=> void") || type.includes("EventHandler")) {
+    return { category: "exclude" };
+  }
+  if (name === "ref" || name === "innerRef" || type.includes("Ref<") || type.includes("RefObject<")) {
+    return { category: "exclude" };
+  }
+  if (name === "testId" || name === "data-testid" || name === "dataTestId") {
+    return { category: "exclude" };
+  }
+  if (name === "key") {
+    return { category: "exclude" };
+  }
+  if (type.includes("Dispatch<") || type.includes("SetStateAction")) {
+    return { category: "exclude" };
+  }
+  if (isDomPassThroughProp(name)) {
+    return { category: "exclude" };
+  }
+  if (name === "name" && prop.domAttribute) {
+    return { category: "exclude" };
+  }
+  if (isStringLiteralUnion(type)) {
+    return { category: "design", cdfTypeHint: "enum" };
+  }
+  if (!isComplexType(type)) {
+    const designNameStart = /^(variant|size|spacing|gap|color|bg|theme|align|layout|orientation|position)/i;
+    const designNameEnd = /(Color|Size|Variant|Style)$/;
+    if (designNameStart.test(name) || designNameEnd.test(name)) {
+      return { category: "design", cdfTypeHint: "string" };
+    }
+  }
+  if (isBooleanType(type)) {
+    const stateNames = ["disabled", "loading", "expanded", "isOpen", "selected", "checked", "active", "preview"];
+    if (stateNames.includes(name)) {
+      return { category: "state", cdfTypeHint: "boolean" };
+    }
+  }
+  if (isBooleanType(type)) {
+    const visualToggle = /^(hide|show|enable|disable|vertical|horizontal|reverse|bold|italic|imageOn|with)/i;
+    if (visualToggle.test(name)) {
+      return { category: "design", cdfTypeHint: "boolean" };
+    }
+  }
+  if (name === "componentId" || name === "sectionKey" || name === "locale" || name === "variantIndex") {
+    return { category: "state", cdfTypeHint: "string" };
+  }
+  if (isStringType(type)) {
+    const urlNameStart = /^(href|url|link|src)/i;
+    const urlNameEnd = /(Url|Href|Link|Src)$/;
+    if (urlNameStart.test(name) || urlNameEnd.test(name)) {
+      return { category: "content", cdfTypeHint: "string" };
+    }
+  }
+  if (isStringType(type)) {
+    const textNameStart = /^(label|title|text|description|caption|heading|subheading|body|alt|name|placeholder|summary)/i;
+    const textNameEnd = /(Text|Label|Title|Name)$/;
+    if (textNameStart.test(name) || textNameEnd.test(name)) {
+      return { category: "content", cdfTypeHint: "string" };
+    }
+  }
+  if (isStringType(type)) {
+    return { category: "content", cdfTypeHint: "string" };
+  }
+  if (isBooleanType(type)) {
+    return { category: "design", cdfTypeHint: "boolean" };
+  }
+  if (isNumberType(type)) {
+    return { category: "design", cdfTypeHint: "string" };
+  }
+  return void 0;
+}
+function preClassifyComponent(component) {
+  const props = component.props.flatMap((prop) => {
+    const result = preClassifyProp(prop);
+    if (result?.category === "exclude") {
+      return [];
+    }
+    const { domAttribute: _domAttribute, ...authorableProp } = prop;
+    if (prop.category) {
+      return [authorableProp];
+    }
+    if (!result) {
+      return [authorableProp];
+    }
+    return [
+      {
+        ...authorableProp,
+        category: result.category
+      }
+    ];
+  });
+  return { ...component, props };
+}
+
 // packages/experience-design-system-backend-pipeline/dist/src/orchestrators/run-extract-and-compose-session/helpers/emit-pre-classification-exclusions.js
 function emitPreClassificationExclusions(extraction, onExclusion) {
   if (!onExclusion)
@@ -28408,7 +27968,7 @@ init_debug_mode_store();
 init_version();
 
 // packages/experience-design-system-cli/src/tui/help/file-locations.ts
-import { join as join25, resolve as resolve27 } from "node:path";
+import { join as join26, resolve as resolve27 } from "node:path";
 function describeFileLocations({
   contentfulBaseDir,
   debugModeEnabled,
@@ -28417,14 +27977,14 @@ function describeFileLocations({
   if (!debugModeEnabled) {
     return {
       debugLogs: "none while Debug Mode is off",
-      importFiles: `${join25("<project>", ".contentful")}/ (tokens.json, components.json)`
+      importFiles: `${join26("<project>", ".contentful")}/ (tokens.json, components.json)`
     };
   }
   const base = contentfulBaseDir ? resolve27(contentfulBaseDir) : "<project>";
-  const session = currentSessionDir2 ?? join25(base, ".contentful", "<date>-session-<n>");
+  const session = currentSessionDir2 ?? join26(base, ".contentful", "<date>-session-<n>");
   return {
-    debugLogs: join25(session, "debug"),
-    importFiles: `${join25(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
+    debugLogs: join26(session, "debug"),
+    importFiles: `${join26(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
   };
 }
 
@@ -29677,51 +29237,74 @@ import { useEffect as useEffect26, useState as useState35 } from "react";
 import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
-import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
+import { Fragment as Fragment21, jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
+var ROWS = ["enabled", "retentionDays"];
+var nextRetention = (current) => RETENTION_CHOICES[(RETENTION_CHOICES.indexOf(current) + 1) % RETENTION_CHOICES.length];
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState35(true);
-  const [enabled, setEnabled] = useState35(true);
+  const [setting, setSetting] = useState35(null);
+  const [focus, setFocus] = useState35("enabled");
   useEffect26(() => {
-    readDebugModeSetting().then((setting) => {
-      setEnabled(setting.enabled);
-      setLoading(false);
+    readDebugModeSetting().then((loaded) => {
+      setSetting(loaded);
       startDebugRun({
         flow: "settings/debug-mode",
         step: "01-debug-mode",
         menuOption: "Debug Mode",
-        inputs: { enabled: setting.enabled }
+        inputs: { ...loaded }
       });
     });
   }, []);
+  const change = (patch) => {
+    if (!setting) return;
+    setSetting({ ...setting, ...patch });
+    void writeDebugModeSetting(patch);
+  };
   useInput16((input, key) => {
-    if (loading) return;
+    if (!setting) return;
+    if (key.upArrow || key.downArrow) {
+      setFocus((current) => ROWS[(ROWS.indexOf(current) + (key.downArrow ? 1 : ROWS.length - 1)) % ROWS.length]);
+      return;
+    }
     if (key.return || input === " ") {
-      setEnabled((current) => {
-        const next = !current;
-        void writeDebugModeSetting({ enabled: next });
-        return next;
-      });
+      if (focus === "enabled") change({ enabled: !setting.enabled });
+      else change({ retentionDays: nextRetention(setting.retentionDays) });
       return;
     }
     if (key.escape || input === "q") {
-      void finishDebugRun({ outputs: { enabled }, status: "success", exitMethod: "saved" });
+      void finishDebugRun({ outputs: { ...setting }, status: "success", exitMethod: "saved" });
       onDone();
     }
   });
+  const marker = (row) => focus === row ? "\u276F" : " ";
   return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
     /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Settings \u203A Debug Mode" }),
     /* @__PURE__ */ jsx62(Text53, { children: " " }),
-    loading ? /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs51(Text53, { children: [
-      "Debug logging:",
-      " ",
-      /* @__PURE__ */ jsx62(Text53, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
-    ] }),
+    setting ? /* @__PURE__ */ jsxs51(Fragment21, { children: [
+      /* @__PURE__ */ jsxs51(Text53, { children: [
+        marker("enabled"),
+        " Debug logging:",
+        " ",
+        /* @__PURE__ */ jsx62(Text53, { bold: true, color: setting.enabled ? PALETTE.success : PALETTE.muted, children: setting.enabled ? "On" : "Off" })
+      ] }),
+      /* @__PURE__ */ jsxs51(Text53, { children: [
+        marker("retentionDays"),
+        " Delete logs after:",
+        " ",
+        /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.accent, children: [
+          setting.retentionDays,
+          " days"
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx62(Text53, { children: " " }),
+      /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Older logs are deleted the next time the CLI starts." })
+    ] }) : /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Loading\u2026" }),
     /* @__PURE__ */ jsx62(Text53, { children: " " }),
     /* @__PURE__ */ jsx62(
       ControlHints,
       {
         hints: [
-          { keys: "\u23CE/Space", label: "toggle" },
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u23CE/Space", label: "change" },
           { keys: "Esc/q", label: "back" }
         ]
       }
@@ -29730,7 +29313,7 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment21, jsx as jsx63 } from "react/jsx-runtime";
+import { Fragment as Fragment22, jsx as jsx63 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
   const [screen, setScreen] = useState36("start");
   const [importExitCode, setImportExitCode] = useState36();
@@ -29779,7 +29362,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state2 = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join26(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join27(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state2.kind === "cached") {
@@ -29899,7 +29482,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment21, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx63(Fragment22, {});
       if (projectPath === void 0) {
         return /* @__PURE__ */ jsx63(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
@@ -29938,7 +29521,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment21, {});
+        return /* @__PURE__ */ jsx63(Fragment22, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
@@ -29975,7 +29558,7 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx63(Fragment21, {});
+        return /* @__PURE__ */ jsx63(Fragment22, {});
       }
       if (pendingLaunch?.cached) {
         return /* @__PURE__ */ jsx63(