@decantr/cli 1.7.22 → 1.7.24

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-BWUEX3IA.js";
-import "./chunk-SN7C63TF.js";
+import "./chunk-7H3PAC5Y.js";
+import "./chunk-RH6IQ7YX.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{chunk-BWUEX3IA.js → chunk-7H3PAC5Y.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-SN7C63TF.js";
+} from "./chunk-RH6IQ7YX.js";
 import {
   buildGuardRegistryContext,
   scanProjectInteractions
@@ -2516,7 +2516,7 @@ var reactViteBootstrapAdapter = {
         react: "^19.0.0",
         "react-dom": "^19.0.0",
         "react-router-dom": "^7.0.0",
-        "@decantr/css": "^1.0.0",
+        "@decantr/css": "^1.0.4",
         // P0-4: Lucide is the canonical icon library Decantr blueprints
         // reference in personality prose ("Lucide icons"). Including it by
         // default means cold scaffolds don't have to hand-roll inline SVGs.
@@ -4013,19 +4013,19 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("Read in this order:");
   lines.push(
-    "1. DECANTR.md for the design spec, treatment catalog, motion/typography/elevation tables, and the Interaction Requirements canonical-implementation table."
+    '1. DECANTR.md for the design spec, "Atoms in 5 minutes" walkthrough, treatment catalog, motion/typography/elevation tables, and the Interaction Requirements canonical-implementation table.'
   );
   lines.push(
-    "2. .decantr/context/scaffold-pack.md for the compact compiled shell, theme, feature, and route contract."
+    '2. .decantr/context/scaffold-pack.md \u2014 the canonical compiled contract. Contains the route plan, shell layouts, navigation, AND the project-wide "Required Theme Decorators" table (class | intent | apply-to). This table is the authoritative decorator contract; section packs reference it.'
   );
   lines.push(
     "3. .decantr/context/scaffold.md for the broader app overview, topology, route map, and voice guidance."
   );
   lines.push(
-    "4. Before working on any section, read its matching .decantr/context/section-*-pack.md and then .decantr/context/section-*.md files."
+    '4. Before working on any section, read its matching .decantr/context/section-*-pack.md (compact contract \u2014 pay close attention to the "Section Directives" block; those are non-negotiable execution rules) and then .decantr/context/section-*.md (long-form context with shell internal_layout + slot guidance).'
   );
   lines.push(
-    "5. Before working on any route/page, read its matching .decantr/context/page-*-pack.md file."
+    '5. Before working on any route/page, read its matching .decantr/context/page-*-pack.md file. The "Interactions (MUST implement each)" checklist per pattern is contract \u2014 see the next section.'
   );
   lines.push("");
   lines.push("\u2550\u2550\u2550 INTERACTIONS ARE CONTRACT, NOT GUIDANCE \u2550\u2550\u2550");
@@ -4063,22 +4063,80 @@ function generateGreenfieldPrompt(ctx) {
     "`decantr check --strict` FAILS the build when a declared interaction has no matching implementation. The full canonical-implementation table is in DECANTR.md."
   );
   lines.push("");
+  lines.push("\u2550\u2550\u2550 ATOMS-FIRST FOR LAYOUT \u2014 DO NOT INLINE-STYLE \u2550\u2550\u2550");
+  lines.push("");
+  lines.push(
+    'Decantr ships @decantr/css as a runtime atom system (already in package.json). Use atoms via `css(...)` for ALL layout, spacing, sizing, flex/grid, position, and typography sizing \u2014 wherever you would otherwise reach for `style={{ display: "flex", gap: "1rem", padding: "1rem", ... }}`.'
+  );
+  lines.push("");
+  lines.push("Mandatory translation (NOT optional). USE THESE EXACT ATOM NAMES:");
+  lines.push(
+    '  \u274C style={{ display: "flex", gap: "1rem" }}                   \u2192  \u2705 className={css("_flex _gap4")}'
+  );
+  lines.push(
+    '  \u274C style={{ flexDirection: "column", alignItems: "center" }}  \u2192  \u2705 className={css("_col _aic")}'
+  );
+  lines.push(
+    '  \u274C style={{ justifyContent: "space-between" }}                \u2192  \u2705 className={css("_jcsb")}'
+  );
+  lines.push(
+    '  \u274C style={{ padding: "1rem 1.5rem" }}                         \u2192  \u2705 className={css("_py4 _px6")}'
+  );
+  lines.push(
+    '  \u274C style={{ gridTemplateColumns: "repeat(3, 1fr)" }}           \u2192  \u2705 className={css("_grid _gc3")}'
+  );
+  lines.push(
+    '  \u274C style={{ position: "sticky", top: 0 }}                     \u2192  \u2705 className={css("_sticky _top0")}'
+  );
+  lines.push(
+    '  \u274C style={{ width: "100%", maxWidth: "40rem" }}               \u2192  \u2705 className={css("_wfull _maxw[40rem]")}'
+  );
+  lines.push(
+    '  \u274C style={{ marginInline: "auto" }}                            \u2192  \u2705 className={css("_mxauto")}'
+  );
+  lines.push(
+    '  \u274C style={{ fontSize: "1.5rem" }}                              \u2192  \u2705 className={css("_text2xl")}'
+  );
+  lines.push("");
+  lines.push(
+    'Atom naming convention: compact prefix-spelling \u2014 `_aic` (align-items:center) not `_items-center`, `_jcsb` (justify-content:space-between) not `_justify-between`, `_wfull` not `_w-full`, `_top0` not `_t0`. The runtime accepts hyphenated Tailwind-style aliases as fallback BUT compact prefix is canonical, shorter, and what every existing scaffold uses. Do not invent your own atom shapes \u2014 if you need an arbitrary value (e.g. `maxWidth: "72rem"`), use the brackets form `_maxw[72rem]`.'
+  );
+  lines.push("");
+  lines.push(
+    'Combine atoms with treatment / decorator strings: `className={css("_flex _col _gap4") + " d-card clean-card"}`.'
+  );
+  lines.push("");
+  lines.push("Inline `style={{...}}` is ONLY acceptable for:");
+  lines.push(
+    '  1. CSS custom-property writes the contract REQUIRES (`style={{ "--d-stagger-index": i }}`, `style={{ "--lum-card-color": accent }}`, etc.)'
+  );
+  lines.push(
+    "  2. Truly dynamic geometry no atom can express (computed pan/zoom transforms, draggable-node positions calculated from data, real-time gradient hue interpolation)."
+  );
+  lines.push("");
+  lines.push(
+    'If you find yourself writing >5 inline styles in a component for static visual values, STOP and migrate to atoms. The full atom reference is in DECANTR.md ("Atoms in 5 minutes" + "Atom Reference"). `decantr check` flags inline-style attributes as a contract violation.'
+  );
+  lines.push("");
   lines.push("\u2550\u2550\u2550 TREATMENT SURFACE \u2014 USE WHAT EXISTS \u2550\u2550\u2550");
   lines.push("");
   lines.push(
-    "40+ treatment classes ship in src/styles/treatments.css. Reach for these BEFORE inventing equivalent CSS. Eight families to know:"
+    "60+ treatment classes ship in src/styles/treatments.css. Reach for these BEFORE inventing equivalent CSS. Families:"
   );
   lines.push(
     "- Core surfaces: d-interactive (data-variant + data-size), d-surface, d-data + d-data-row/cell/header, d-control, d-section, d-annotation, d-label"
   );
   lines.push(
-    "- Common UI: d-link, d-icon-btn (data-size + data-variant), d-nav-link, d-step-chip, d-divider-{top,bottom,left,right}"
+    '- Common UI: d-link, d-icon-btn (data-size + data-variant), d-nav-link, d-step-chip (data-step-state="pending|active|done"), d-divider-{top,bottom,left,right}'
+  );
+  lines.push(
+    "- Utility primitives (1.7.21): d-tooltip (data-position), d-empty-state, d-breadcrumb + d-breadcrumb-item (data-current) + d-breadcrumb-separator, d-avatar (data-size), d-icon-well (data-size), d-toggle (data-on), d-toc + d-toc-item (data-current), d-popover"
   );
   lines.push(
     '- Spatial / graph: d-agent-node, d-port (data-side, data-active); d-cta-banner; d-interactive[data-variant="dark"]'
   );
   lines.push(
-    '- Shells: d-shell + data-layout="sidebar-main|centered|top-nav-footer|sidebar-aside", d-shell-sidebar, d-shell-main, d-shell-aside, d-shell-header, d-shell-body, d-shell-footer, d-shell-centered-card'
+    '- Shells (14 layouts shipped): d-shell + data-layout="sidebar-main | centered | top-nav-footer | sidebar-aside | top-nav-main | minimal-header | full-bleed | recipefork-top-nav | canvas-overlay | chat-portal | copilot-overlay | terminal-split | three-column-browser | workspace-aside". Child regions: d-shell-sidebar, d-shell-main, d-shell-aside, d-shell-header, d-shell-body, d-shell-footer, d-shell-centered-card, d-shell-list (three-column-browser), d-shell-copilot (copilot-overlay), d-shell-status-bar + d-shell-hotkey-bar (terminal-split), d-shell-overlay (canvas-overlay, with data-corner). d-shell-mobile-trigger + d-shell-mobile-backdrop close the mobile drawer loop.'
   );
   lines.push(
     '- Modal / palette: d-modal (data-align="top"), d-modal-backdrop, d-modal-panel (data-size="sm|lg"), d-palette + d-palette-input/list/row/section, d-kbd, d-hotkey-indicator'
@@ -4099,6 +4157,15 @@ function generateGreenfieldPrompt(ctx) {
     "Token scales are tunable via CSS vars: --d-motion-{instant,fast,base,slow,slower}, --d-text-{xs..6xl}, --d-elevation-{1..5}, --d-tracking-*, --d-leading-*, --d-weight-*. Themes override per-blueprint."
   );
   lines.push("");
+  lines.push("\u2550\u2550\u2550 THEME DECORATOR CONTRACT \u2014 APPLY OR THE THEME DOES NOT LAND \u2550\u2550\u2550");
+  lines.push("");
+  lines.push(
+    'Each theme ships 5-15 namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). The full Class | Intent | Apply-to contract for the active theme is in scaffold-pack.md under "Required Theme Decorators". Apply them as additive classes alongside d-* treatments \u2014 that is what makes the theme look like the theme rather than "themed colors only."'
+  );
+  lines.push(
+    'Section packs ship a one-line pointer to the scaffold-pack table; the canonical contract is in scaffold-pack.md (also mirrored in DECANTR.md "Decorator Quick Reference" with intent + apply-to + key CSS).'
+  );
+  lines.push("");
   lines.push("\u2550\u2550\u2550 HARD RULES (NON-NEGOTIABLE) \u2550\u2550\u2550");
   lines.push("");
   lines.push(
@@ -4110,6 +4177,12 @@ function generateGreenfieldPrompt(ctx) {
   lines.push(
     "- Use lucide-react for ALL iconography (already in package.json). Pick semantic icons (Bot, Activity, Database, Search) over generic ones. Do NOT inline SVGs for icons that have Lucide equivalents."
   );
+  lines.push(
+    "- Section Directives (when present in section-*-pack.md) are non-negotiable execution rules. They define layout proportions, treatment stacks (e.g., card-grid uses d-card + d-elevate[1] + d-lift-hover + theme card decorator + d-stagger-children), copy conventions, and pattern-fitness rules per section. Honor them exactly \u2014 they encode product-quality decisions the registry author made for this archetype."
+  );
+  lines.push(
+    "- Filter chip rows / tab strips MUST use d-step-chip with data-step-state, NOT bare d-interactive. d-step-chip ships proper active-fill, hover-tint, and chip-row sizing. Bare buttons make filter rows look like generic SaaS form controls."
+  );
   lines.push("");
   lines.push("\u2550\u2550\u2550 IMPLEMENTATION RULES \u2550\u2550\u2550");
   lines.push(
@@ -4153,7 +4226,7 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("- Build the shell and shared layout first.");
   lines.push("- Then implement each section's pages using the matching section and page packs.");
   lines.push(
-    "- After implementation, run `decantr check`. It runs 8 guard rules including the experiential interactions guard (8th rule, v2.1 C5). It fails strict-mode builds when declared interactions[] are not implemented; the suggestions point at the canonical implementation. `decantr audit` is deprecated \u2014 `decantr check` is the unified entry point."
+    "- After implementation, run `decantr check` (primary gate \u2014 8 guard rules including the experiential interactions guard). It fails strict-mode builds when declared interactions[] are not implemented; the suggestions point at the canonical implementation. Run `decantr audit` (supplementary \u2014 surfaces inline-style counts, security hygiene findings, accessibility / auth-flow advisories) for deeper diagnostics."
   );
   lines.push("- Fix all violations until `decantr check` exits 0.");
   lines.push(
@@ -5942,7 +6015,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-HN6REFEX.js");
+      const { cmdUpgrade } = await import("./upgrade-7LHT3S7E.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/{chunk-SN7C63TF.js → chunk-RH6IQ7YX.js}

@@ -2889,12 +2889,15 @@ import './styles/global.css';                // Resets
 | \u274C Inline (DO NOT) | \u2705 Atom (DO) |
 |--------------------|------------|
 | \`style={{ display: 'flex', gap: '1rem' }}\` | \`className={css('_flex _gap4')}\` |
-| \`style={{ flexDirection: 'column', alignItems: 'center' }}\` | \`className={css('_col _items-center')}\` |
+| \`style={{ flexDirection: 'column', alignItems: 'center' }}\` | \`className={css('_col _aic')}\` |
 | \`style={{ padding: '1rem 1.5rem' }}\` | \`className={css('_py4 _px6')}\` |
-| \`style={{ width: '100%', maxWidth: '40rem' }}\` | \`className={css('_w-full _maxw[40rem]')}\` |
+| \`style={{ width: '100%', maxWidth: '40rem' }}\` | \`className={css('_wfull _maxw[40rem]')}\` |
 | \`style={{ display: 'grid', gridTemplateColumns: 'repeat(3, 1fr)' }}\` | \`className={css('_grid _gc3')}\` |
-| \`style={{ position: 'sticky', top: 0 }}\` | \`className={css('_sticky _t0')}\` |
+| \`style={{ position: 'sticky', top: 0 }}\` | \`className={css('_sticky _top0')}\` |
 | \`style={{ marginInline: 'auto' }}\` | \`className={css('_mxauto')}\` |
+| \`style={{ fontSize: '1.5rem' }}\` | \`className={css('_text2xl')}\` |
+
+> **Naming convention:** atoms use compact prefix-spelling (\`_aic\`, \`_jcsb\`, \`_wfull\`, \`_top0\`) \u2014 not Tailwind-style hyphenation. The runtime accepts both (\`_aic\` and \`_items-center\` both resolve to \`align-items:center\`) but compact prefix is canonical and shorter.
 
 **Inline \`style={{ ... }}\` is ONLY acceptable for these cases:**
 1. **CSS custom property writes** \u2014 \`style={{ '--d-stagger-index': i }}\` (the contract REQUIRES inline writes for dynamic CSS-var values that loop variables / animation indices feed into).

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-BWUEX3IA.js";
-import "./chunk-SN7C63TF.js";
+import "./chunk-7H3PAC5Y.js";
+import "./chunk-RH6IQ7YX.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{upgrade-HN6REFEX.js → upgrade-7LHT3S7E.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.22",
+  "version": "1.7.24",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",