@decantr/cli 1.7.15 → 1.7.18

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-M2DFCY3N.js";
-import "./chunk-WINKQSUX.js";
+import "./chunk-VHDAHJKS.js";
+import "./chunk-5ZMHI3R4.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{chunk-WINKQSUX.js → chunk-5ZMHI3R4.js}

@@ -763,12 +763,60 @@ ${themeBody}
   lines.push("    bottom: 0;");
   lines.push("    z-index: 50;");
   lines.push("    transform: translateX(-100%);");
+  lines.push("    box-shadow: var(--d-elevation-4, 0 8px 24px rgba(0,0,0,0.25));");
   lines.push("  }");
   lines.push('  .d-shell-sidebar[data-mobile-open="true"] {');
   lines.push("    transform: translateX(0);");
   lines.push("  }");
   lines.push("}");
   lines.push("");
+  emitRule(".d-shell-mobile-trigger", [
+    ["display", "none"],
+    ["align-items", "center"],
+    ["justify-content", "center"],
+    ["width", "36px"],
+    ["height", "36px"],
+    ["border", "1px solid var(--d-border)"],
+    ["border-radius", "var(--d-radius-sm)"],
+    ["background", "transparent"],
+    ["color", "var(--d-text)"],
+    ["cursor", "pointer"],
+    ["flex-shrink", "0"],
+    [
+      "transition",
+      "background var(--d-motion-fast, 150ms) var(--d-motion-ease-out, cubic-bezier(0,0,0.2,1)), border-color var(--d-motion-fast, 150ms) var(--d-motion-ease-out, cubic-bezier(0,0,0.2,1))"
+    ]
+  ]);
+  emitRule(".d-shell-mobile-trigger:hover", [
+    ["background", "var(--d-surface)"],
+    ["border-color", "var(--d-primary)"]
+  ]);
+  emitRule(".d-shell-mobile-trigger:focus-visible", [
+    ["outline", "2px solid var(--d-primary)"],
+    ["outline-offset", "2px"]
+  ]);
+  emitRule(".d-shell-mobile-backdrop", [
+    ["display", "none"],
+    ["position", "fixed"],
+    ["inset", "0"],
+    ["z-index", "49"],
+    ["background", "color-mix(in srgb, var(--d-bg) 60%, transparent)"],
+    ["backdrop-filter", "blur(2px)"],
+    ["-webkit-backdrop-filter", "blur(2px)"],
+    [
+      "transition",
+      "opacity var(--d-motion-fast, 150ms) var(--d-motion-ease-out, cubic-bezier(0,0,0.2,1))"
+    ]
+  ]);
+  lines.push("@media (max-width: 767.98px) {");
+  lines.push("  .d-shell-mobile-trigger {");
+  lines.push("    display: inline-flex;");
+  lines.push("  }");
+  lines.push('  .d-shell-mobile-backdrop[data-visible="true"] {');
+  lines.push("    display: block;");
+  lines.push("  }");
+  lines.push("}");
+  lines.push("");
   emitRule(".d-shell-main", [
     ["display", "flex"],
     ["flex-direction", "column"],
@@ -795,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)"],
@@ -2495,9 +2551,11 @@ 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. |
+| **Mobile backdrop** | \`d-shell-mobile-backdrop\` | Dim scrim shown behind the open sidebar drawer below \`_md:\`. Apply \`data-visible="true"\` when sidebar is open; click to close. Hidden above \`_md:\`. |
 
 **Shell layout recipes:**
 - **Auth / confirmation:** \`d-shell[data-layout="centered"] + d-shell-centered-card\`.
@@ -2507,6 +2565,47 @@ Pair \`d-card\` with a theme card decorator (e.g., \`carbon-card\`) for hover gl
 
 Do NOT hand-roll \`.shell-sidebar\`, \`.shell-centered\`, \`.shell-tnf\`, \`.shell-aside\`, \`.sidebar-main-layout\`, or similar class names. They exist as treatments.
 
+**Mobile sidebar wiring (REQUIRED for sidebar-main / sidebar-aside shells):**
+
+The sidebar collapses to off-canvas below \`_mdmax:\`. Without an explicit toggle, mobile users get stuck \u2014 collapsed sidebar, no way to re-open it. Wire it up like this:
+
+\`\`\`tsx
+function AppShell() {
+  const [navOpen, setNavOpen] = useState(false);
+  return (
+    <div className="d-shell" data-layout="sidebar-main">
+      <aside
+        className="d-shell-sidebar"
+        data-mobile-open={navOpen ? 'true' : undefined}
+      >
+        {/* nav items */}
+      </aside>
+      <div
+        className="d-shell-mobile-backdrop"
+        data-visible={navOpen ? 'true' : undefined}
+        onClick={() => setNavOpen(false)}
+      />
+      <main className="d-shell-main">
+        <header className="d-shell-header">
+          <button
+            className="d-shell-mobile-trigger"
+            aria-label={navOpen ? 'Close navigation' : 'Open navigation'}
+            aria-expanded={navOpen}
+            onClick={() => setNavOpen((v) => !v)}
+          >
+            <Menu size={18} aria-hidden />
+          </button>
+          {/* rest of header */}
+        </header>
+        <div className="d-shell-body">{/* page content */}</div>
+      </main>
+    </div>
+  );
+}
+\`\`\`
+
+The trigger auto-hides above \`_md:\` (where the sidebar is always visible inline) and the backdrop only shows when \`data-visible="true"\` AND viewport is below \`_md:\`. Close-on-route-change is recommended for SPA blueprints \u2014 wire \`useEffect\` on \`location.pathname\` to reset \`navOpen\` to false.
+
 ### Theme toggle
 
 If the blueprint declares the \`theme-toggle\` feature, \`tokens.css\` includes a \`[data-mode="<opposite>"]\` selector block. Flip the visible mode by setting \`data-mode\` on \`<html>\` (or any ancestor):

package/dist/{chunk-M2DFCY3N.js → chunk-VHDAHJKS.js}

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

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-M2DFCY3N.js";
-import "./chunk-WINKQSUX.js";
+import "./chunk-VHDAHJKS.js";
+import "./chunk-5ZMHI3R4.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{upgrade-Q7PHW34P.js → upgrade-LK3Z44M2.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.15",
+  "version": "1.7.18",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@decantr/core": "1.0.2",
-    "@decantr/essence-spec": "1.0.4",
+    "@decantr/essence-spec": "1.0.5",
     "@decantr/verifier": "1.0.3",
     "@decantr/registry": "1.0.2"
   },