@decantr/cli 1.6.7 → 1.7.0

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import "./chunk-3ZYYVKWA.js";
-import "./chunk-XUX3ZLCK.js";
+import "./chunk-RQUIYILX.js";
+import "./chunk-X4RHL7WQ.js";

package/dist/{chunk-3ZYYVKWA.js → chunk-RQUIYILX.js}

@@ -9,7 +9,7 @@ import {
   scaffoldMinimal,
   scaffoldProject,
   syncRegistry
-} from "./chunk-XUX3ZLCK.js";
+} from "./chunk-X4RHL7WQ.js";
 
 // src/index.ts
 import { readFileSync as readFileSync15, existsSync as existsSync23, readdirSync as readdirSync6 } from "fs";
@@ -4332,7 +4332,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-QPHY2ER6.js");
+      const { cmdUpgrade } = await import("./upgrade-2KX7BKEK.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/{chunk-XUX3ZLCK.js → chunk-X4RHL7WQ.js}

@@ -922,6 +922,14 @@ Atoms + treatment + theme decorator:
 - **Theme decorators:** \`carbon-glass\`, \`carbon-code\` \u2014 theme-specific decoration from treatments.css
 - **Combined:** \`css('_flex _col') + ' d-surface carbon-card'\`
 
+\`\`\`tsx
+// Responsive prefix \u2014 applies at breakpoint and above:
+css('_col sm:_row')
+
+// Pseudo prefix:
+css('hover:_opacity80')
+\`\`\`
+
 ### Atom Reference
 
 #### Display
@@ -1131,7 +1139,15 @@ Check \`decantr.essence.json\` \u2192 \`meta.platform.routing\` for the routing
 - \`"hash"\` \u2192 use \`HashRouter\` (e.g., for static hosting, GitHub Pages)
 - \`"history"\` \u2192 use \`BrowserRouter\` (e.g., for server-rendered apps)
 
-Routes are defined in \`decantr.essence.json\` \u2192 \`blueprint.routes\` and listed in \`.decantr/context/scaffold.md\`.`;
+Routes are defined in \`decantr.essence.json\` \u2192 \`blueprint.routes\` and listed in \`.decantr/context/scaffold.md\`.
+
+### Layout Rules
+
+1. **Never nest d-surface inside d-surface.** Inner sections use plain containers with padding atoms.
+2. **Shell regions are frames, not surfaces.** Sidebar and header use var(--d-surface) or var(--d-bg) directly. Apply d-surface only to content cards within the body region.
+3. **One scroll container per region.** Body has overflow-y-auto. Sidebar nav has its own overflow-y-auto. Never nest additional scrollable wrappers.
+4. **d-section spacing is self-contained.** Each d-section owns its padding. The d-section + d-section rule adds a separator. Do NOT add extra margin between adjacent sections.
+5. **Responsive nav rules.** Hamburger menus appear ONLY below the shell collapse breakpoint. Full nav shows above it.`;
 function generateDecantrMdV31(params) {
   const template = loadTemplate("DECANTR.md.template");
   const body = renderTemplate(template, {
@@ -1867,7 +1883,10 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
               description: inner.description || "",
               regions: inner.config?.regions || [],
               layout: inner.layout || void 0,
-              guidance: inner.guidance || void 0
+              guidance: inner.guidance || void 0,
+              atoms: inner.atoms || void 0,
+              config: inner.config || void 0,
+              internal_layout: inner.internal_layout || void 0
             };
           }
         } catch {
@@ -1914,7 +1933,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         constraints: essence.dna.constraints,
         shellInfo: shellInfoCache[section.shell],
         themeData,
-        themeMode: mode
+        themeMode: mode,
+        voiceTone: storedVoice?.tone ? storedVoice.tone.split(".")[0] + "." : void 0
       });
       const sectionContextPath = join(contextDir, `section-${section.id}.md`);
       writeFileSync(sectionContextPath, contextContent);
@@ -1979,7 +1999,10 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
           description: inner.description || "",
           regions: inner.config?.regions || [],
           layout: inner.layout || void 0,
-          guidance: inner.guidance || void 0
+          guidance: inner.guidance || void 0,
+          atoms: inner.atoms || void 0,
+          config: inner.config || void 0,
+          internal_layout: inner.internal_layout || void 0
         };
       }
     } catch {
@@ -2001,7 +2024,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       constraints: essence.dna.constraints,
       shellInfo: v30ShellInfo,
       themeData,
-      themeMode: mode
+      themeMode: mode,
+      voiceTone: storedVoice?.tone ? storedVoice.tone.split(".")[0] + "." : void 0
     });
     const sectionContextPath = join(contextDir, `section-${syntheticSection.id}.md`);
     writeFileSync(sectionContextPath, contextContent);
@@ -2100,6 +2124,136 @@ function generateSyntheticComponents(patternId, description) {
   if (patternId.includes("empty") || patternId.includes("new")) syntheticComponents.push("Icon", "Text", "Button");
   return [...new Set(syntheticComponents)];
 }
+function generateShellImplementation(shellId, shellInfo) {
+  const lines = [];
+  lines.push(`## Shell Implementation (${shellId})`);
+  lines.push("");
+  if (shellInfo.internal_layout && Object.keys(shellInfo.internal_layout).length > 0) {
+    for (const [region, props] of Object.entries(shellInfo.internal_layout)) {
+      lines.push(`### ${region}`);
+      lines.push("");
+      if (typeof props === "object" && props !== null) {
+        for (const [key, value] of Object.entries(props)) {
+          if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            lines.push(`- **${key}:**`);
+            for (const [subKey, subValue] of Object.entries(value)) {
+              lines.push(`  - ${subKey}: ${subValue}`);
+            }
+          } else {
+            lines.push(`- **${key}:** ${value}`);
+          }
+        }
+      } else {
+        lines.push(`- ${props}`);
+      }
+      lines.push("");
+    }
+    lines.push("### Anti-patterns");
+    lines.push("");
+    lines.push("- Do NOT nest `overflow-y-auto` inside another `overflow-y-auto` \u2014 one scroll container per region.");
+    lines.push("- Do NOT apply `d-surface` to shell frame regions (sidebar, header). Use `var(--d-surface)` or `var(--d-bg)` directly.");
+    lines.push("- Do NOT add wrapper `<div>` elements around shell regions \u2014 the grid areas handle placement.");
+    lines.push("");
+  } else {
+    if (shellInfo.layout) {
+      lines.push(`**Layout:** ${shellInfo.layout}`);
+      lines.push("");
+    }
+    if (shellInfo.atoms) {
+      lines.push(`**Atoms:** \`${shellInfo.atoms}\``);
+      lines.push("");
+    }
+    if (shellInfo.config) {
+      const cfg = shellInfo.config;
+      if (cfg.nav) {
+        const navParts = [];
+        if (cfg.nav.position) navParts.push(`position: ${cfg.nav.position}`);
+        if (cfg.nav.width) navParts.push(`width: ${cfg.nav.width}`);
+        if (cfg.nav.collapseTo) navParts.push(`collapses to: ${cfg.nav.collapseTo}`);
+        if (cfg.nav.collapseBelow) navParts.push(`below: ${cfg.nav.collapseBelow}`);
+        if (navParts.length > 0) lines.push(`**Nav:** ${navParts.join(", ")}`);
+      }
+      if (cfg.header) {
+        const headerParts = [];
+        if (cfg.header.height) headerParts.push(`height: ${cfg.header.height}`);
+        if (cfg.header.sticky) headerParts.push("sticky");
+        if (headerParts.length > 0) lines.push(`**Header:** ${headerParts.join(", ")}`);
+      }
+      if (cfg.body) {
+        const bodyParts = [];
+        if (cfg.body.scroll) bodyParts.push("overflow-y: auto");
+        if (cfg.body.inputAnchored) bodyParts.push("input anchored to bottom");
+        if (bodyParts.length > 0) lines.push(`**Body:** ${bodyParts.join(", ")}`);
+      }
+      if (cfg.footer) {
+        const footerParts = [];
+        if (cfg.footer.height) footerParts.push(`height: ${cfg.footer.height}`);
+        if (cfg.footer.sticky) footerParts.push("sticky");
+        if (footerParts.length > 0) lines.push(`**Footer:** ${footerParts.join(", ")}`);
+      }
+      lines.push("");
+    }
+  }
+  return lines;
+}
+function generateQuickStart(input) {
+  const { section, shellInfo, decorators, personality, voiceTone } = input;
+  const lines = [];
+  lines.push("## Quick Start");
+  lines.push("");
+  const shellDesc = shellInfo?.description || `${section.shell} shell`;
+  const dims = [];
+  if (shellInfo?.config?.nav?.width) dims.push(`nav: ${shellInfo.config.nav.width}`);
+  if (shellInfo?.config?.header?.height) dims.push(`header: ${shellInfo.config.header.height}`);
+  lines.push(`**Shell:** ${shellDesc}${dims.length > 0 ? ` (${dims.join(", ")})` : ""}`);
+  const pageNames = section.pages.map((p) => p.id);
+  lines.push(`**Pages:** ${section.pages.length} (${pageNames.join(", ")})`);
+  const patternLabels = [];
+  const specEntries = Object.entries(input.patternSpecs);
+  for (const [name, spec] of specEntries) {
+    const count = spec.components.length;
+    if (count >= 8) patternLabels.push(`${name} [complex]`);
+    else if (count >= 4) patternLabels.push(`${name} [moderate]`);
+    else patternLabels.push(name);
+  }
+  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);
+  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 density = section.dna_overrides?.density || "comfortable";
+  lines.push(`**Density:** ${density}`);
+  if (voiceTone) {
+    lines.push(`**Voice:** ${voiceTone}`);
+  }
+  lines.push("");
+  return lines;
+}
+function generateSpacingGuide(density) {
+  const lines = [];
+  const level = density === "compact" || density === "spacious" ? density : "comfortable";
+  const tokens = computeSpatialTokens(level);
+  lines.push("## Spacing Guide");
+  lines.push("");
+  lines.push("| Context | Token | Value | Usage |");
+  lines.push("|---------|-------|-------|-------|");
+  lines.push(`| Content gap | \`--d-content-gap\` | \`${tokens["--d-content-gap"]}\` | Gap between sibling elements |`);
+  lines.push(`| Section padding | \`--d-section-py\` | \`${tokens["--d-section-py"]}\` | Vertical padding on d-section |`);
+  lines.push(`| Surface padding | \`--d-surface-p\` | \`${tokens["--d-surface-p"]}\` | Inner padding for d-surface |`);
+  lines.push(`| Interactive V | \`--d-interactive-py\` | \`${tokens["--d-interactive-py"]}\` | Vertical padding on buttons |`);
+  lines.push(`| Interactive H | \`--d-interactive-px\` | \`${tokens["--d-interactive-px"]}\` | Horizontal padding on buttons |`);
+  lines.push(`| Control | \`--d-control-py\` | \`${tokens["--d-control-py"]}\` | Vertical padding on inputs |`);
+  lines.push(`| Data row | \`--d-data-py\` | \`${tokens["--d-data-py"]}\` | Vertical padding on table rows |`);
+  lines.push("");
+  return lines;
+}
 function generateSectionContext(input) {
   const { section, decorators, guardConfig, personality, themeName, zoneContext, patternSpecs, themeHints, constraints, shellInfo } = input;
   const lines = [];
@@ -2107,10 +2261,6 @@ function generateSectionContext(input) {
   lines.push("");
   lines.push(`**Role:** ${section.role} | **Shell:** ${section.shell} | **Archetype:** ${section.id}`);
   lines.push(`**Description:** ${section.description}`);
-  if (shellInfo) {
-    lines.push(`**Shell structure:** ${shellInfo.description}`);
-    lines.push(`**Regions:** ${shellInfo.regions.join(", ")}`);
-  }
   if (section.dna_overrides) {
     const parts = [];
     if (section.dna_overrides.density) parts.push(`density: ${section.dna_overrides.density}`);
@@ -2120,6 +2270,10 @@ function generateSectionContext(input) {
     }
   }
   lines.push("");
+  lines.push(...generateQuickStart(input));
+  if (shellInfo) {
+    lines.push(...generateShellImplementation(section.shell, shellInfo));
+  }
   if (shellInfo?.guidance && Object.keys(shellInfo.guidance).length > 0) {
     lines.push(`## Shell Notes (${section.shell})`);
     lines.push("");
@@ -2129,6 +2283,8 @@ function generateSectionContext(input) {
     }
     lines.push("");
   }
+  const density = section.dna_overrides?.density || "comfortable";
+  lines.push(...generateSpacingGuide(density));
   lines.push("---");
   lines.push("");
   lines.push(`**Guard:** ${guardConfig.mode} mode | DNA violations = ${guardConfig.dna_enforcement} | Blueprint violations = ${guardConfig.blueprint_enforcement}`);
@@ -2401,8 +2557,6 @@ function generateScaffoldContext(input) {
     if (input.voice.metrics_format) lines.push(`**Metrics format:** ${input.voice.metrics_format}`);
     lines.push("");
   }
-  lines.push("## App Topology");
-  lines.push("");
   lines.push(topologyMarkdown);
   lines.push("");
   lines.push("## Sections Overview");

package/dist/index.js

@@ -1,2 +1,2 @@
-import "./chunk-3ZYYVKWA.js";
-import "./chunk-XUX3ZLCK.js";
+import "./chunk-RQUIYILX.js";
+import "./chunk-X4RHL7WQ.js";

package/dist/{upgrade-QPHY2ER6.js → upgrade-2KX7BKEK.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.6.7",
+  "version": "1.7.0",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@decantr/essence-spec": "1.0.0-beta.11",
-    "@decantr/registry": "1.0.0-beta.11"
+    "@decantr/registry": "1.0.0-beta.12"
   },
   "scripts": {
     "build": "tsup",