@decantr/cli 1.7.17 → 1.7.19

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-AMP4C5NV.js";
-import "./chunk-BABBST2Q.js";
+import "./chunk-GHLSLSRW.js";
+import "./chunk-26JRGQ54.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{chunk-BABBST2Q.js → chunk-26JRGQ54.js}

@@ -473,9 +473,6 @@ ${themeBody}
     ["padding-left", "var(--d-label-px)"],
     ["border-left", "2px solid var(--d-accent)"]
   ]);
-  emitRule("* + .d-label[data-anchor]", [
-    ["margin-top", "var(--d-section-gap, 2rem)"]
-  ]);
   emitRule(".d-link", [
     ["color", "var(--d-text)"],
     ["text-decoration", "none"],
@@ -846,11 +843,19 @@ ${themeBody}
     ["min-width", "0"],
     ["overflow-y", "auto"],
     ["overflow-x", "clip"],
-    ["padding", "1rem"]
+    ["padding", "1rem"],
+    ["display", "flex"],
+    ["flex-direction", "column"],
+    ["gap", "var(--d-section-gap, 2rem)"]
   ]);
   emitRule('.d-shell-body[data-padding="compact"]', [["padding", "0.75rem"]]);
   emitRule('.d-shell-body[data-padding="spacious"]', [["padding", "1.5rem"]]);
   emitRule('.d-shell-body[data-padding="none"]', [["padding", "0"]]);
+  emitRule('.d-shell-body[data-flow="tight"]', [["gap", "0.75rem"]]);
+  emitRule('.d-shell-body[data-flow="none"]', [
+    ["display", "block"],
+    ["gap", "0"]
+  ]);
   emitRule(".d-shell-footer", [
     ["padding", "1rem clamp(1rem, 2vw, 1.5rem)"],
     ["border-top", "1px solid var(--d-border)"],
@@ -2546,7 +2551,7 @@ Pair \`d-card\` with a theme card decorator (e.g., \`carbon-card\`) for hover gl
 | **Main** | \`d-shell-main\` | Remaining-width column to the right of the sidebar (or the full content area in top-nav shells). Handles scroll internally. |
 | **Aside** | \`d-shell-aside\` | Right 320px auxiliary panel for inspector / timeline / minimap in \`sidebar-aside\` layouts. Below \`_mdmax:\` hides by default; toggle with \`data-mobile-open="true"\`. |
 | **Header** | \`d-shell-header\` | 52px sticky top bar with horizontal flex layout. Use inside \`d-shell-main\` (sidebar-main shells) or at the top of \`d-shell\` (top-nav shells). |
-| **Body** | \`d-shell-body\` | Scrollable main region. \`data-padding="compact\\|spacious\\|none"\` overrides the default 1rem padding. |
+| **Body** | \`d-shell-body\` | Scrollable main region. **Flex column with section-level gap (\`var(--d-section-gap, 2rem)\`) between direct children** \u2014 every block-level child (eyebrow, card grid, chart row, table) gets uniform spacing automatically, no matter how it's wrapped internally. \`data-padding="compact\\|spacious\\|none"\` adjusts the outer 1rem padding. \`data-flow="tight"\` reduces the gap to 0.75rem; \`data-flow="none"\` reverts to plain block flow. |
 | **Footer** | \`d-shell-footer\` | Narrow band below the body with top border. |
 | **Centered card** | \`d-shell-centered-card\` | The content parent inside \`d-shell[data-layout="centered"]\`. Caps width at 28rem. |
 | **Mobile menu trigger** | \`d-shell-mobile-trigger\` | Hamburger button hidden above \`_md:\`, visible below. Toggles \`data-mobile-open\` on the sibling \`d-shell-sidebar\`. REQUIRED inside \`d-shell-header\` for any \`sidebar-main\` or \`sidebar-aside\` shell \u2014 without it, mobile users can't re-open the collapsed nav. |
@@ -3165,12 +3170,18 @@ Start implementation from the shell layouts and shared route structure before fi
   }
   briefLines.push(`- **Guard mode:** ${params.guardMode}`);
   briefLines.push("");
+  const escDecCell = (s) => s.replace(/\|/g, "\\|");
   if (params.decoratorDefinitions && Object.keys(params.decoratorDefinitions).length > 0) {
     briefLines.push("### Decorator Quick Reference");
-    briefLines.push("| Class | Intent | Key CSS |");
-    briefLines.push("|-------|--------|---------|");
+    briefLines.push(
+      `Apply these classes \u2014 they carry the theme's visual identity. Without them the scaffold reads as "themed colors only."`
+    );
+    briefLines.push("");
+    briefLines.push("| Class | Intent | Apply to | Key CSS |");
+    briefLines.push("|-------|--------|----------|---------|");
     for (const [name, def] of Object.entries(params.decoratorDefinitions)) {
-      const intent = def.intent || "";
+      const intent = escDecCell(def.intent || "");
+      const applyTo = escDecCell((def.usage || []).join(", "));
       const props = def.suggested_properties ?? def.css ?? {};
       const base = Object.entries(props).map(([p, v]) => `${p}: ${v}`).join("; ");
       const hasHover = def.hover_properties && Object.keys(def.hover_properties).length > 0;
@@ -3182,7 +3193,9 @@ Start implementation from the shell layouts and shared route structure before fi
         hasActive && ":active"
       ].filter((m) => Boolean(m));
       const stateSuffix = stateMarkers.length > 0 ? ` _(+ ${stateMarkers.join(", ")})_` : "";
-      briefLines.push(`| \`.${name}\` | ${intent} | ${base}${stateSuffix} |`);
+      briefLines.push(
+        `| \`.${name}\` | ${intent} | ${applyTo} | ${escDecCell(base)}${stateSuffix} |`
+      );
     }
     briefLines.push("");
   } else if (params.decorators && params.decorators.length > 0) {
@@ -3190,7 +3203,7 @@ Start implementation from the shell layouts and shared route structure before fi
     briefLines.push("| Class | Purpose |");
     briefLines.push("|-------|---------|");
     for (const d of params.decorators) {
-      briefLines.push(`| \`.${d.name}\` | ${d.description} |`);
+      briefLines.push(`| \`.${d.name}\` | ${escDecCell(d.description)} |`);
     }
     briefLines.push("");
   }
@@ -4593,14 +4606,20 @@ function generateQuickStart(input) {
   if (patternLabels.length > 0) {
     lines.push(`**Key patterns:** ${patternLabels.join(", ")}`);
   }
-  const cssClasses = [];
-  const topDecorators = decorators.slice(0, 3).map((d) => d.name);
-  cssClasses.push(...topDecorators);
+  if (decorators.length > 0) {
+    const count = decorators.length;
+    lines.push(
+      `**Theme decorators:** ${count} class${count === 1 ? "" : "es"} \u2014 see "Required Theme Decorators" below for class + intent + apply-to`
+    );
+  }
   const pLower = personality.join(" ").toLowerCase();
-  if (pLower.includes("neon") || pLower.includes("glow")) cssClasses.push("neon-glow");
-  if (pLower.includes("mono") || pLower.includes("monospace")) cssClasses.push("mono-data");
-  if (cssClasses.length > 0) {
-    lines.push(`**CSS classes:** ${cssClasses.map((c) => `\`.${c}\``).join(", ")}`);
+  const personalityUtils = [];
+  if (pLower.includes("neon") || pLower.includes("glow")) personalityUtils.push("neon-glow");
+  if (pLower.includes("mono") || pLower.includes("monospace")) personalityUtils.push("mono-data");
+  if (personalityUtils.length > 0) {
+    lines.push(
+      `**Personality utilities:** ${personalityUtils.map((c) => `\`.${c}\``).join(", ")}`
+    );
   }
   const density = section.dna_overrides?.density || "comfortable";
   lines.push(`**Density:** ${density}`);
@@ -4751,21 +4770,38 @@ function generateSectionContext(input) {
   );
   lines.push("");
   const decoratorDefs = input.themeData?.decorator_definitions;
+  const escCell = (s) => s.replace(/\|/g, "\\|");
   if (decoratorDefs && Object.keys(decoratorDefs).length > 0) {
-    const usageEntries = Object.entries(decoratorDefs).filter(
-      ([, def]) => def.usage && def.usage.length > 0
+    const renderableEntries = Object.entries(decoratorDefs).filter(
+      ([, def]) => def.intent || def.description || def.usage && def.usage.length > 0
     );
-    if (usageEntries.length > 0) {
-      lines.push("**Section decorators (usage hints):**");
-      for (const [name, def] of usageEntries) {
-        lines.push(`- \`.${name}\`: ${(def.usage || []).join(", ")}`);
+    if (renderableEntries.length > 0) {
+      lines.push(`## Required Theme Decorators (${themeName})`);
+      lines.push("");
+      lines.push(
+        `These classes carry the active theme's visual identity. Tokens alone give bones; decorators give personality. Generated source MUST apply these \u2014 without them, the page reads as "themed colors only" with no theme character.`
+      );
+      lines.push("");
+      lines.push("| Class | Intent | Apply to |");
+      lines.push("|-------|--------|----------|");
+      for (const [name, def] of renderableEntries) {
+        const intent = escCell(def.intent || def.description || "");
+        const applyTo = escCell((def.usage || []).join(", "));
+        lines.push(`| \`.${name}\` | ${intent} | ${applyTo} |`);
       }
       lines.push("");
     }
   } else if (decorators.length > 0) {
-    lines.push("**Section decorators:**");
+    lines.push(`## Required Theme Decorators (${themeName})`);
+    lines.push("");
+    lines.push(
+      "These classes carry the active theme's visual identity. Apply them across this section's patterns or the scaffold reads as generic."
+    );
+    lines.push("");
+    lines.push("| Class | Description |");
+    lines.push("|-------|-------------|");
     for (const d of decorators) {
-      lines.push(`- \`.${d.name}\` \u2014 ${d.description}`);
+      lines.push(`| \`.${d.name}\` | ${escCell(d.description)} |`);
     }
     lines.push("");
   }

package/dist/{chunk-AMP4C5NV.js → chunk-GHLSLSRW.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-BABBST2Q.js";
+} from "./chunk-26JRGQ54.js";
 import {
   buildGuardRegistryContext,
   scanProjectInteractions
@@ -5942,7 +5942,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-ARXL7WCP.js");
+      const { cmdUpgrade } = await import("./upgrade-LVMAKWEA.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-AMP4C5NV.js";
-import "./chunk-BABBST2Q.js";
+import "./chunk-GHLSLSRW.js";
+import "./chunk-26JRGQ54.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{upgrade-ARXL7WCP.js → upgrade-LVMAKWEA.js}

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-BABBST2Q.js";
+} from "./chunk-26JRGQ54.js";
 
 // src/commands/upgrade.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.17",
+  "version": "1.7.19",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -27,10 +27,10 @@
     "access": "public"
   },
   "dependencies": {
+    "@decantr/core": "1.0.2",
     "@decantr/essence-spec": "1.0.5",
-    "@decantr/verifier": "1.0.3",
     "@decantr/registry": "1.0.2",
-    "@decantr/core": "1.0.2"
+    "@decantr/verifier": "1.0.3"
   },
   "scripts": {
     "build": "tsup",