@birdapi/velinstyle 1.2.0 → 1.2.2

package/cli/index.js

@@ -45,6 +45,7 @@ const LAYER_FILES = {
     'components/timeline.css', 'components/stepper.css', 'components/stat.css',
     'components/drawer.css', 'components/input-group.css', 'components/form-validation.css', 'components/collapse.css',
     'components/calendar-dropzone.css',
+    'components/transparency.css',
   ],
   utilities: [
     'utilities/color.css', 'utilities/spacing.css', 'utilities/display.css',
@@ -91,6 +92,8 @@ function help() {
   ${C.bold('Usage:')}
     velinstyle init                 Create velinstyle.config.js
     velinstyle build                Build custom CSS with selected layers
+    velinstyle build --production   Content-aware production output (CSS/JS/themes/icons)
+    velinstyle production [path]    Alias for build --production
     velinstyle themes               List available themes
     velinstyle add <name>           Add a single component CSS
     velinstyle icons <subcommand>   Manage icon providers
@@ -101,9 +104,14 @@ function help() {
     velinstyle create <kind> [dir]  Scaffold: landing|dashboard|docs|auth
     velinstyle serve [dir]          Static preview server (default port 4173)
     velinstyle doctor               Check dist, icons, config, Windows ESM paths
-    velinstyle check [path]         doctor + blueprint --strict + scan + review
+    velinstyle transparency <sub>   Transparency Framework: doctor|validate|report|export|migrate
+    velinstyle check [path]         doctor + blueprint --strict + scan + review + transparency
     velinstyle scaffold "<prompt>"  Plan-first page HTML or recipe fragment
+    velinstyle scaffold --atelier 04,07  Compose Atelier Library ids (beta)
     velinstyle plan "<prompt>"      Emit page plan JSON (no HTML)
+    velinstyle plan --atelier 04,07 Emit plan JSON for Atelier ids (beta)
+    velinstyle atelier <num|id>     Pull curated Atelier Library showcase
+    velinstyle atelier list         List curated Library numbers/ids
     velinstyle review [file|html]   Design / a11y / SEO / conversion review gate
     velinstyle wc api <tag>         Human-readable Web Component API from source
     velinstyle layout <sub>         Responsive layout audit and fixes
@@ -145,11 +153,27 @@ function help() {
     velinstyle scaffold "<prompt>"  Plan → render → review for pages; recipes for fragments
     velinstyle scaffold list-intents  Show recipe intent keywords
     velinstyle scaffold "<prompt>" -o out.html [--json]
+    velinstyle scaffold --atelier 04,07 [-o page.html] [--from <library>]  Compose Library showcases (beta)
 
-  ${C.bold('Plan / Review (1.2.0):')}
+  ${C.bold('Atelier Library pull (1.2.x):')}
+    velinstyle atelier list
+    velinstyle atelier 36 [-o dir] [--format html|blade|vue|react] [--from <library>] [--base-url <url>]
+    Limitation: blade/vue/react = integration wrappers around vanilla assets (not native rewrites).
+    Native framework blocks / Velin Studio Builder = planned. Atelier ≠ Studio.
+
+  ${C.bold('Plan / Review (1.2.x):')}
     velinstyle plan "<prompt>" [--json] [-o plan.json]
+    velinstyle plan --atelier 04,07 [-o plan.json]  Atelier compose plan (beta)
     velinstyle review <file.html> [--json] [--prompt "..."]
 
+  ${C.bold('Transparency (1.2.1):')}
+    velinstyle transparency doctor [path|file] [--policy file] [--json]
+    velinstyle transparency validate [path|file] [--policy file] [--json]
+    velinstyle transparency report [path|file] [--out dir] [--policy file]
+    velinstyle transparency export [path|file] [--format json|json-ld|csv|html] [-o file]
+    velinstyle transparency migrate [path|file] [--apply] [--write] [--policy file]
+    Alias: transparency scan → doctor
+
   ${C.bold('Layout (0.8.0):')}
     velinstyle layout audit [path]    Report flex/grid/responsive issues
     velinstyle layout suggest [path]  Audit with fix suggestions
@@ -160,6 +184,16 @@ function help() {
     velinstyle perf suggest [path|file] Same as audit with fix hints
     velinstyle perf fix [path|file]   Apply safe fixes (--write)
 
+  ${C.bold('Production Builder (1.2.2):')}
+    velinstyle build --production [path]
+    velinstyle production [path]
+      --out, -o <dir>          Default: ./dist/velin-production
+      --explain                Show removed CSS/themes/icons + reasons
+      --watch                  Rebuild on content change
+      --report <file>          Write JSON/Markdown report
+      --safelist <list|file>   Extra classes / themes / icons / CSS files
+      --no-js --no-icons --no-themes --no-motion --no-minify
+
   ${C.bold('Tokens:')}
     velinstyle tokens build [--input <path>] [--output, -o <file>]
     velinstyle tokens validate [--input <path>]
@@ -300,6 +334,13 @@ export default {
 // ── Build ────────────────────────────────────────────────────────────────────
 
 async function build() {
+  if (hasFlag('--production')) {
+    const { runProduction } = await import('./production/run.js');
+    const rest = args.slice(1).filter((a) => a !== '--production');
+    await runProduction({ args: rest, helpers: { getArg, hasFlag, C } });
+    return;
+  }
+
   const configPath = resolve('velinstyle.config.js');
   let config;
 
@@ -777,6 +818,60 @@ async function prefixCmd() {
   }
 }
 
+async function atelierCmd() {
+  const sub = args[1];
+  const {
+    listAtelierEntries,
+    pullAtelier,
+  } = await import('./atelier.js');
+
+  if (!sub || sub === '--help' || sub === '-h') {
+    console.log(`Usage: velinstyle atelier list
+       velinstyle atelier <num|id> [-o dir] [--format html|blade|vue|react]
+         [--from <library-root>] [--base-url <url>] [--rewrite-vendor <path>]
+
+  Pull a curated Atelier Library showcase (e.g. 36 → 36-calendar).
+  Limitation: --format blade|vue|react writes integration shells only (not native rewrites).
+  Velin Studio Builder and native framework blocks are planned — not shipped.`);
+    return;
+  }
+
+  if (sub === 'list') {
+    const r = listAtelierEntries();
+    if (!r.ok) {
+      console.log(C.red(r.error));
+      process.exit(1);
+    }
+    console.log(`\n  ${C.bold('Atelier Library (curated)')} · ${r.items.length} templates\n`);
+    for (const it of r.items) {
+      console.log(`    ${C.cyan(it.num.padStart(3))}  ${it.id}  ${C.dim(it.title || '')}`);
+    }
+    console.log(`\n  ${C.dim('Example: velinstyle atelier 36 -o ./velin-atelier/36-calendar')}\n`);
+    return;
+  }
+
+  const out = getArg('--output', '-o');
+  const format = getArg('--format') || 'html';
+  const from = getArg('--from') || process.env.VELINSTYLE_ATELIER_ROOT || null;
+  const baseUrl = getArg('--base-url');
+  const rewriteVendor = getArg('--rewrite-vendor');
+
+  const r = await pullAtelier(sub, {
+    output: out || undefined,
+    format,
+    from: from || undefined,
+    baseUrl: baseUrl || undefined,
+    rewriteVendor: rewriteVendor || undefined,
+  });
+  if (!r.ok) {
+    console.log(C.red(r.error));
+    process.exit(1);
+  }
+  console.log(C.green(`Pulled ${r.entry.id} → ${r.path} (format: ${r.format})`));
+  console.log(C.dim(`  source: ${r.source}`));
+  console.log(C.dim('  Limitation: blade/vue/react = wrappers; Studio/native rewrites planned.'));
+}
+
 async function scaffoldCmd() {
   const sub = args[1];
   const { scaffoldFromPrompt, listIntents } = await import('./scaffold.js');
@@ -789,6 +884,38 @@ async function scaffoldCmd() {
     console.log('');
     return;
   }
+
+  const atelierList = getArg('--atelier');
+  if (atelierList) {
+    const { composeAtelierPage } = await import('./atelier.js');
+    const out = getArg('--output', '-o') || resolve('velin-atelier/compose.html');
+    const from = getArg('--from') || process.env.VELINSTYLE_ATELIER_ROOT || null;
+    const baseUrl = getArg('--base-url');
+    const r = await composeAtelierPage(atelierList, {
+      output: out,
+      from: from || undefined,
+      baseUrl: baseUrl || undefined,
+    });
+    if (!r.ok) {
+      console.log(C.red(r.error));
+      process.exit(1);
+    }
+    if (hasFlag('--json')) {
+      console.log(JSON.stringify({
+        ok: true,
+        mode: r.mode,
+        path: r.path,
+        entries: r.entries,
+        planSections: r.planSections,
+      }, null, 2));
+    } else {
+      console.log(C.green(`Wrote Atelier compose (beta) → ${r.path}`));
+      console.log(C.dim(`  ids: ${r.entries.map((e) => e.id).join(', ')}`));
+      console.log(C.dim('  Beta: Library compose — not Velin Studio. Wrappers ≠ native rewrites.'));
+    }
+    return;
+  }
+
   const promptParts = [];
   let i = 1;
   while (i < args.length) {
@@ -800,6 +927,7 @@ async function scaffoldCmd() {
   const prompt = promptParts.join(' ').trim() || sub;
   if (!prompt || prompt === 'list-intents') {
     console.log('Usage: velinstyle scaffold "<description>" [-o file.html] [--json]');
+    console.log('       velinstyle scaffold --atelier 04,07 [-o page.html] [--from <library>]');
     return;
   }
   const r = scaffoldFromPrompt(prompt);
@@ -826,6 +954,24 @@ async function scaffoldCmd() {
 }
 
 async function planCmd() {
+  const atelierList = getArg('--atelier');
+  if (atelierList) {
+    const { planFromAtelierList } = await import('./atelier.js');
+    const payload = planFromAtelierList(atelierList, { prompt: args.slice(1).filter((a) => !a.startsWith('-')).join(' ') });
+    if (!payload.ok) {
+      console.log(C.red(payload.error));
+      process.exit(1);
+    }
+    const out = getArg('--output', '-o');
+    if (out) {
+      writeFileSync(resolve(out), JSON.stringify(payload, null, 2), 'utf-8');
+      console.log(C.green(`Wrote Atelier plan (beta) ${resolve(out)} (${payload.plan.sections.length} sections)`));
+      return;
+    }
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
   const promptParts = [];
   let i = 1;
   while (i < args.length) {
@@ -837,6 +983,7 @@ async function planCmd() {
   const prompt = promptParts.join(' ').trim();
   if (!prompt) {
     console.log('Usage: velinstyle plan "<description>" [--json] [-o plan.json]');
+    console.log('       velinstyle plan --atelier 04,07 [-o plan.json]');
     return;
   }
   const { analyzePrompt, buildPlan } = await import('./prompt-engine.js');
@@ -877,7 +1024,10 @@ async function reviewCmd() {
     console.log(JSON.stringify(report, null, 2));
   } else {
     console.log(`\n  ${C.bold('Review gate:')} ${report.gate}  ${C.dim(`profile ${report.profile} · promptScore ${report.promptScore}`)}`);
-    console.log(C.dim(`  design ${report.scores.design} · a11y ${report.scores.accessibility} · seo ${report.scores.seo} · perf ${report.scores.performance} · conversion ${report.scores.conversion}`));
+    console.log(C.dim(`  design ${report.scores.design} · a11y ${report.scores.accessibility} · seo ${report.scores.seo} · perf ${report.scores.performance} · conversion ${report.scores.conversion} · opt ${report.scores.optimization ?? '—'}`));
+    if (report.optimization) {
+      console.log(C.dim(`  optimization · unused themes ${report.optimization.unusedThemes} · WC tags ${report.optimization.componentTags} · class tokens ${report.optimization.classTokens}`));
+    }
     if (report.issues.length) {
       console.log(`\n  ${C.bold('Issues:')}`);
       for (const issue of report.issues) {
@@ -1123,6 +1273,20 @@ async function checkCmd() {
     steps.push({ step: 'review', ok: true, skipped: true });
   }
 
+  if (!quiet) console.log(C.bold('\n── transparency ──'));
+  try {
+    const { transparencyCheckStep } = await import('./transparency.js');
+    const tx = await transparencyCheckStep(htmlFile || target, { quiet, C });
+    if (!tx.ok && !tx.skipped) failed += 1;
+    if (!quiet && tx.scores) {
+      console.log(`Transparency ${tx.scores.transparency}% · AI ${tx.scores.ai}% · Trust ${tx.scores.trust}% · Provenance ${tx.scores.provenance}%`);
+    }
+    steps.push({ step: 'transparency', ok: tx.ok || !!tx.skipped, scores: tx.scores, skipped: tx.skipped });
+  } catch (err) {
+    if (!quiet) console.log(C.yellow(`transparency skipped: ${err.message}`));
+    steps.push({ step: 'transparency', ok: true, skipped: true, error: String(err.message || err) });
+  }
+
   const payload = {
     ok: failed === 0,
     failedSteps: failed,
@@ -1181,8 +1345,8 @@ async function checkCmd() {
 function suggestCommand(unknown) {
   const names = [
     'init', 'build', 'themes', 'add', 'icons', 'blueprint', 'create', 'serve', 'doctor', 'check',
-    'validate', 'tokens', 'scan', 'prefix', 'scaffold', 'plan', 'review', 'layout', 'perf',
-    'docs', 'documentation', 'meta', 'search', 'skills', 'workflow', 'wc',
+    'validate', 'tokens', 'scan', 'prefix', 'scaffold', 'plan', 'review', 'transparency', 'layout', 'perf',
+    'docs', 'documentation', 'meta', 'search', 'skills', 'workflow', 'wc', 'production', 'atelier',
   ];
   const q = String(unknown || '').toLowerCase();
   function editDistance(a, b) {
@@ -1229,7 +1393,12 @@ const resolvedCommand = ALIASES[command] || command;
 
 switch (resolvedCommand) {
   case 'init': init(); break;
-  case 'build': build(); break;
+  case 'build': await build(); break;
+  case 'production': {
+    const { runProduction } = await import('./production/run.js');
+    await runProduction({ args: args.slice(1), helpers: { getArg, hasFlag, C } });
+    break;
+  }
   case 'themes': themes(); break;
   case 'add': add(); break;
   case 'icons': icons(); break;
@@ -1243,7 +1412,13 @@ switch (resolvedCommand) {
   case 'prefix': await prefixCmd(); break;
   case 'scaffold': await scaffoldCmd(); break;
   case 'plan': await planCmd(); break;
+  case 'atelier': await atelierCmd(); break;
   case 'review': await reviewCmd(); break;
+  case 'transparency': {
+    const { transparencyCmd } = await import('./transparency.js');
+    await transparencyCmd(args.slice(1), { C, getArg, hasFlag });
+    break;
+  }
   case 'layout': await layoutCmd(); break;
   case 'perf': await perfCmd(); break;
   case 'docs': await docsCmd(); break;

package/cli/production/component-graph.json

@@ -0,0 +1,166 @@
+{
+  "version": 1,
+  "alwaysCss": [
+    "tokens/fonts.css",
+    "tokens/color.css",
+    "tokens/spacing.css",
+    "tokens/typography.css",
+    "tokens/radius.css",
+    "tokens/shadow.css",
+    "tokens/motion.css",
+    "tokens/z-index.css",
+    "tokens/aspect-ratio.css",
+    "base/root.css",
+    "base/reset.css",
+    "base/focus.css",
+    "base/content.css",
+    "a11y/sr-only.css",
+    "a11y/skip-link.css",
+    "a11y/reduced-motion.css",
+    "a11y/forced-colors.css",
+    "a11y/focus-appearance.css",
+    "a11y/target-size.css",
+    "layout/breakpoints.css",
+    "layout/container.css"
+  ],
+  "classPrefixes": {
+    "velin-btn": { "css": ["components/button.css"] },
+    "velin-card": { "css": ["components/card.css"] },
+    "velin-input": { "css": ["components/input.css", "components/form-validation.css"] },
+    "velin-textarea": { "css": ["components/input.css", "components/form-validation.css"] },
+    "velin-select": { "css": ["components/input.css", "components/form-validation.css"] },
+    "velin-label": { "css": ["components/input.css"] },
+    "velin-field": { "css": ["components/input.css", "components/form-validation.css"] },
+    "velin-nav": { "css": ["components/nav.css"] },
+    "velin-navbar": { "css": ["components/nav.css"] },
+    "velin-alert": { "css": ["components/alert.css"] },
+    "velin-badge": { "css": ["components/badge.css"] },
+    "velin-table": { "css": ["components/table.css"] },
+    "velin-data-table": { "css": ["components/data-table.css", "components/table.css"] },
+    "velin-tooltip": { "css": ["components/tooltip.css"] },
+    "velin-modal": { "css": ["components/modal.css", "components/button.css"] },
+    "velin-dialog": { "css": ["components/modal.css", "components/button.css"] },
+    "velin-breadcrumb": { "css": ["components/breadcrumb.css"] },
+    "velin-pagination": { "css": ["components/pagination.css"] },
+    "velin-progress": { "css": ["components/progress.css"] },
+    "velin-spinner": { "css": ["components/spinner.css"] },
+    "velin-list": { "css": ["components/list-group.css"] },
+    "velin-avatar": { "css": ["components/avatar.css"] },
+    "velin-switch": { "css": ["components/switch.css"] },
+    "velin-divider": { "css": ["components/divider.css"] },
+    "velin-chip": { "css": ["components/chip.css"] },
+    "velin-timeline": { "css": ["components/timeline.css"] },
+    "velin-stepper": { "css": ["components/stepper.css"] },
+    "velin-stat": { "css": ["components/stat.css"] },
+    "velin-drawer": { "css": ["components/drawer.css", "components/button.css"] },
+    "velin-sheet": { "css": ["components/drawer.css", "components/button.css"] },
+    "velin-input-group": { "css": ["components/input-group.css", "components/input.css"] },
+    "velin-collapse": { "css": ["components/collapse.css"] },
+    "velin-accordion": { "css": ["components/collapse.css"] },
+    "velin-calendar": { "css": ["components/calendar-dropzone.css"] },
+    "velin-dropzone": { "css": ["components/calendar-dropzone.css"] },
+    "velin-grid": { "css": ["layout/grid.css"] },
+    "velin-flex": { "css": ["layout/flex.css"] },
+    "velin-container": { "css": ["layout/container.css"] },
+    "velin-stack": { "css": ["layout/patterns.css"] },
+    "velin-cluster": { "css": ["layout/patterns.css"] },
+    "velin-sidebar": { "css": ["layout/patterns.css", "layout/app-shell.css"] },
+    "velin-app": { "css": ["layout/app-shell.css"] },
+    "velin-shell": { "css": ["layout/app-shell.css"] },
+    "velin-skeleton": { "css": ["a11y/skeleton.css"] },
+    "velin-sr-only": { "css": ["a11y/sr-only.css"] },
+    "velin-skip": { "css": ["a11y/skip-link.css"] },
+    "velin-transparency": { "css": ["components/transparency.css"] },
+    "velin-disclosure": { "css": ["components/transparency.css"] },
+    "velin-otp-input": { "css": ["components/empty-auth.css", "components/input.css"] },
+    "velin-password-strength": { "css": ["components/empty-auth.css", "components/progress.css"] },
+    "velin-empty-state": { "css": ["components/empty-auth.css", "components/button.css"] }
+  },
+  "wc": {
+    "velin-modal": { "css": ["components/modal.css", "components/button.css"], "peers": ["velin-icon"] },
+    "velin-dialog": { "css": ["components/modal.css", "components/button.css"], "peers": ["velin-icon"] },
+    "velin-drawer": { "css": ["components/drawer.css", "components/button.css"], "peers": [] },
+    "velin-sheet": { "css": ["components/drawer.css", "components/button.css"], "peers": [] },
+    "velin-toast": { "css": ["components/alert.css"], "peers": ["velin-icon"] },
+    "velin-tooltip": { "css": ["components/tooltip.css"], "peers": [] },
+    "velin-tooltip-wc": { "css": ["components/tooltip.css"], "peers": [] },
+    "velin-tabs": { "css": ["components/nav.css"], "peers": [] },
+    "velin-icon": { "css": [], "peers": [] },
+    "velin-accordion": { "css": ["components/collapse.css"], "peers": [] },
+    "velin-collapse": { "css": ["components/collapse.css"], "peers": [] },
+    "velin-dropdown": { "css": ["components/nav.css", "components/button.css"], "peers": [] },
+    "velin-popover": { "css": ["components/tooltip.css"], "peers": [] },
+    "velin-carousel": { "css": [], "peers": ["velin-icon"] },
+    "velin-lightbox": { "css": ["components/modal.css"], "peers": ["velin-icon"] },
+    "velin-data-table": { "css": ["components/data-table.css", "components/table.css"], "peers": [] },
+    "velin-stepper": { "css": ["components/stepper.css"], "peers": [] },
+    "velin-stepper-wc": { "css": ["components/stepper.css"], "peers": [] },
+    "velin-theme-toggle": { "css": ["components/button.css"], "peers": ["velin-icon"] },
+    "velin-search": { "css": ["components/input.css", "components/input-group.css"], "peers": ["velin-icon"] },
+    "velin-combobox": { "css": ["components/input.css"], "peers": [] },
+    "velin-command": { "css": ["components/modal.css", "components/input.css"], "peers": [] },
+    "velin-bottom-nav": { "css": ["components/nav.css"], "peers": ["velin-icon"] },
+    "velin-menubar": { "css": ["components/nav.css"], "peers": [] },
+    "velin-calendar": { "css": ["components/calendar-dropzone.css"], "peers": [] },
+    "velin-file-dropzone": { "css": ["components/calendar-dropzone.css"], "peers": [] },
+    "velin-progress-ring": { "css": ["components/progress.css"], "peers": [] },
+    "velin-rating": { "css": ["components/chip.css"], "peers": ["velin-icon"] },
+    "velin-scroll-top": { "css": ["components/button.css"], "peers": ["velin-icon"] },
+    "velin-scrollspy": { "css": [], "peers": [] },
+    "velin-sparkline": { "css": [], "peers": [] },
+    "velin-countdown": { "css": ["components/stat.css"], "peers": [] },
+    "velin-counter": { "css": ["components/stat.css"], "peers": [] },
+    "velin-live-dot": { "css": ["components/badge.css"], "peers": [] },
+    "velin-announcer": { "css": ["a11y/sr-only.css"], "peers": [] },
+    "velin-copy": { "css": ["components/button.css"], "peers": ["velin-icon"] },
+    "velin-email": { "css": ["components/input.css"], "peers": [] },
+    "velin-secure-field": { "css": ["components/input.css", "a11y/security.css"], "peers": [] },
+    "velin-form-summary": { "css": ["components/form-validation.css", "components/alert.css"], "peers": [] },
+    "velin-persist": { "css": [], "peers": [] },
+    "velin-code-block": { "css": [], "peers": [] },
+    "velin-segmented-control": { "css": ["components/chip.css", "components/button.css"], "peers": [] },
+    "velin-otp-input": { "css": ["components/empty-auth.css", "components/input.css"], "peers": [] },
+    "velin-password-strength": { "css": ["components/empty-auth.css", "components/progress.css"], "peers": [] },
+    "velin-empty-state": { "css": ["components/empty-auth.css", "components/button.css"], "peers": [] }
+  },
+  "utilityFiles": [
+    "utilities/color.css",
+    "utilities/spacing.css",
+    "utilities/display.css",
+    "utilities/text.css",
+    "utilities/sizing.css",
+    "utilities/border.css",
+    "utilities/position.css",
+    "utilities/animation.css",
+    "utilities/gradient.css",
+    "utilities/print.css",
+    "utilities/responsive.css",
+    "utilities/divide.css",
+    "utilities/scroll.css",
+    "utilities/color-mix.css",
+    "utilities/scroll-animation.css",
+    "utilities/view-transition.css",
+    "utilities/scope.css",
+    "utilities/anchor.css",
+    "utilities/filter.css",
+    "utilities/filter-effects.css",
+    "utilities/chart-animation.css",
+    "utilities/container-style.css",
+    "utilities/state.css",
+    "utilities/safe-area.css"
+  ],
+  "motionFiles": [
+    "utilities/animation.css",
+    "utilities/scroll-animation.css",
+    "utilities/chart-animation.css",
+    "utilities/view-transition.css",
+    "tokens/motion.css",
+    "a11y/reduced-motion.css"
+  ],
+  "fontClassPrefixes": [
+    "velin-font-",
+    "velin-text-",
+    "velin-leading-",
+    "velin-tracking-"
+  ]
+}

package/cli/production/explain.js

@@ -0,0 +1,52 @@
+/**
+ * --explain: human-readable removals with reasons.
+ */
+export function buildExplain({
+  skippedCss = [],
+  skippedThemes = [],
+  skippedIcons = [],
+  skippedMotion = false,
+  graphExplain = [],
+} = {}) {
+  const removed = [];
+
+  for (const item of skippedCss) {
+    removed.push({
+      id: item.file || item,
+      reason: item.reason || 'Nicht benutzt',
+    });
+  }
+  for (const theme of skippedThemes) {
+    removed.push({ id: `${theme}.theme.css`, reason: 'Nicht benutzt' });
+  }
+  for (const icon of skippedIcons.slice(0, 40)) {
+    removed.push({ id: `icon:${icon}`, reason: 'Nicht benutzt' });
+  }
+  if (skippedIcons.length > 40) {
+    removed.push({ id: `icon:…(+${skippedIcons.length - 40})`, reason: 'Nicht benutzt' });
+  }
+  if (skippedMotion) {
+    removed.push({ id: 'motion utilities', reason: 'Keine Animate-/Motion-Klassen gefunden' });
+  }
+
+  const kept = [];
+  const seen = new Set();
+  for (const e of graphExplain) {
+    if (!e.keep || seen.has(e.keep)) continue;
+    seen.add(e.keep);
+    kept.push({ id: e.keep, reason: e.reason });
+  }
+
+  const lines = ['Entfernt'];
+  if (!removed.length) lines.push('(nichts entfernt — oder Scan fand fast alles)');
+  for (const r of removed) {
+    lines.push(`${r.id.padEnd(28)} ${r.reason}`);
+  }
+  lines.push('');
+  lines.push('Behalten (Auszug)');
+  for (const k of kept.slice(0, 30)) {
+    lines.push(`${k.id.padEnd(28)} ${k.reason}`);
+  }
+
+  return { removed, kept, text: lines.join('\n') };
+}