@decantr/cli 1.5.4 → 1.5.5

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import "./chunk-D3W3MYKT.js";
-import "./chunk-T7CQSJGV.js";
+import "./chunk-4KKFOXBB.js";
+import "./chunk-MU3657R7.js";

package/dist/{chunk-D3W3MYKT.js → chunk-4KKFOXBB.js}

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

package/dist/{chunk-T7CQSJGV.js → chunk-MU3657R7.js}

@@ -93,6 +93,9 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
     ["box-shadow", "var(--d-shadow-lg)"],
     ["z-index", "50"]
   ]);
+  emitRule(".d-surface[data-interactive]", [
+    ["cursor", "pointer"]
+  ]);
   emitRule(".d-surface[data-interactive]:hover", [
     ["border-color", "var(--d-primary-hover, var(--d-border))"],
     ["box-shadow", "var(--d-shadow-md)"],
@@ -154,7 +157,13 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
     ["padding", "var(--d-section-py) 0"]
   ]);
   lines.push(".d-section + .d-section {");
-  lines.push("  border-top: 1px solid var(--d-border);");
+  lines.push("  border-top: 1px solid transparent;");
+  lines.push("  border-image: linear-gradient(to right, transparent, var(--d-border), transparent) 1;");
+  lines.push("  margin-top: var(--d-gap-2);");
+  lines.push("}");
+  lines.push("");
+  lines.push('.d-section[data-density="compact"] {');
+  lines.push("  padding: calc(var(--d-section-py) * 0.5) 0;");
   lines.push("}");
   lines.push("");
   emitRule(".d-annotation", [
@@ -185,6 +194,14 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
     ["background", "color-mix(in srgb, var(--d-info) 15%, transparent)"],
     ["color", "var(--d-info)"]
   ]);
+  emitRule(".d-label", [
+    ["font-size", "0.7rem"],
+    ["font-weight", "600"],
+    ["text-transform", "uppercase"],
+    ["letter-spacing", "0.08em"],
+    ["color", "var(--d-text-muted)"],
+    ["font-family", "var(--d-font-mono, ui-monospace, monospace)"]
+  ]);
   if (themeDecorators && Object.keys(themeDecorators).length > 0) {
     const label = themeName ? ` (${themeName})` : "";
     lines.push(`/* \u2500\u2500 Layer 3: Theme Decorators${label} \u2500\u2500 */`);
@@ -208,6 +225,35 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
   lines.push("}");
   return lines.join("\n");
 }
+function generatePersonalityCSS(personality, themeData) {
+  const text = personality.join(" ").toLowerCase();
+  const rules = [];
+  if (text.includes("neon") || text.includes("glow")) {
+    const glowColor = "var(--d-accent-glow, rgba(0, 212, 255, 0.3))";
+    rules.push(`.neon-glow { box-shadow: 0 0 20px ${glowColor}; }`);
+    rules.push(`.neon-glow-hover:hover { box-shadow: 0 0 24px ${glowColor}; transition: box-shadow var(--d-duration-hover, 0.15s) var(--d-easing, ease); }`);
+    rules.push(`.neon-text-glow { text-shadow: 0 0 12px ${glowColor}; }`);
+    rules.push(`.neon-border-glow { border-color: var(--d-accent); box-shadow: 0 0 8px ${glowColor}; }`);
+  }
+  if (text.includes("monospace") || text.includes("mono")) {
+    rules.push(`.mono-data { font-family: var(--d-font-mono, ui-monospace, monospace); font-variant-numeric: tabular-nums; }`);
+  }
+  if (text.includes("pulse") || text.includes("ring") || text.includes("status")) {
+    rules.push(`.status-ring { width: 48px; height: 48px; border-radius: 50%; border: 2px solid var(--d-border); display: flex; align-items: center; justify-content: center; position: relative; transition: border-color 0.2s ease, box-shadow 0.2s ease; }`);
+    rules.push(`.status-ring[data-status="active"] { border-color: var(--d-success); }`);
+    rules.push(`.status-ring[data-status="error"] { border-color: var(--d-error); box-shadow: 0 0 12px color-mix(in srgb, var(--d-error) 25%, transparent); }`);
+    rules.push(`.status-ring[data-status="warning"] { border-color: var(--d-warning); }`);
+    rules.push(`.status-ring[data-status="idle"] { border-color: var(--d-text-muted); }`);
+    rules.push(`@keyframes pulse-ring { 0% { opacity: 0.6; transform: scale(1); } 100% { opacity: 0; transform: scale(1.3); } }`);
+    rules.push(`.status-ring[data-status="active"]::after { content: ''; position: absolute; inset: -4px; border-radius: 50%; border: 2px solid var(--d-success); opacity: 0; animation: pulse-ring 2s ease-out infinite; }`);
+  }
+  if (themeData.motion?.entrance) {
+    rules.push(`.entrance-fade { animation: decantr-entrance var(--d-duration-entrance, 0.2s) var(--d-easing, ease-out); }`);
+    rules.push(`@keyframes decantr-entrance { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }`);
+  }
+  if (rules.length === 0) return "";
+  return "\n/* \u2500\u2500 Personality-Derived Utilities \u2500\u2500 */\n\n" + rules.join("\n\n") + "\n";
+}
 
 // src/scaffold.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
@@ -627,35 +673,6 @@ input, button, textarea, select {
 }
 `;
 }
-function generateTreatmentsContext(themeData, themeName) {
-  const lines = [];
-  lines.push(`# Visual Treatments: ${themeName}`);
-  lines.push("");
-  lines.push("## Base Treatments");
-  lines.push("");
-  lines.push("d-interactive, d-surface, d-data, d-control, d-section, d-annotation \u2014 see DECANTR.md for usage.");
-  lines.push("");
-  if (themeData?.decorators && Object.keys(themeData.decorators).length > 0) {
-    lines.push(`## Theme Decorators (${themeName}-specific)`);
-    lines.push("");
-    lines.push("| Class | Use for |");
-    lines.push("|-------|---------|");
-    for (const [name, description] of Object.entries(themeData.decorators)) {
-      const useFor = description.split(".")[0].trim();
-      lines.push(`| ${name} | ${useFor} |`);
-    }
-    lines.push("");
-  }
-  lines.push("## Composition");
-  lines.push("");
-  lines.push("Atoms + treatment + theme decorator:");
-  lines.push("```tsx");
-  lines.push(`css('_flex _col _gap4') + ' d-surface'`);
-  lines.push("```");
-  lines.push("");
-  lines.push("Atoms use `css()` function. Treatments and theme decorators are plain class strings.");
-  return lines.join("\n");
-}
 function generateDecoratorRule(name, description) {
   const rules = [];
   const descLower = description.toLowerCase();
@@ -1067,19 +1084,38 @@ Atoms + treatment + theme decorator:
 ### Atoms Quick Reference
 
 | Category | Examples | Purpose |
-|----------|----------|---------|
+|----------|---------|---------|
 | Layout | \`_flex\`, \`_col\`, \`_row\`, \`_wrap\`, \`_grid\` | Flex/grid containers |
 | Spacing | \`_gap4\`, \`_p4\`, \`_px4\`, \`_py2\`, \`_m0\` | Gaps, padding, margin |
-| Sizing | \`_w100\`, \`_h100\`, \`_minw0\`, \`_maxwfull\` | Width, height |
-| Text | \`_textlg\`, \`_text2xl\`, \`_fontbold\`, \`_textc\` | Typography |
+| Sizing | \`_w100\`, \`_h100\`, \`_mw640\`, \`_mw480\` | Width, height, max-width |
+| Text | \`_textlg\`, \`_text2xl\`, \`_fontbold\`, \`_fontmono\` | Typography |
+| Color | \`_fgaccent\`, \`_fgmuted\`, \`_fgsuccess\`, \`_bgsurf\` | Foreground/background |
 | Alignment | \`_aic\`, \`_jcc\`, \`_jcsb\`, \`_pic\` | Flex/grid alignment |
 | Position | \`_rel\`, \`_abs\`, \`_sticky\`, \`_z10\` | Positioning |
 | Visual | \`_rounded\`, \`_shadow\`, \`_trans\`, \`_op50\` | Decoration |
-| Color | \`_bgprimary\`, \`_fgtext\`, \`_fgmuted\`, \`_bcborder\` | Theme colors |
 | Responsive | \`_md:gc2\`, \`_lg:gc4\`, \`_sm:flex\` | Breakpoint prefixes |
+| Cursor | \`_pointer\` | Interaction hints |
 
 Scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24. Example: \`_gap4\` = \`gap:1rem\`.
 
+### Section Labels
+
+Use the d-label class for uppercase section headings.
+Anchor with a left accent border: \`border-left: 2px solid var(--d-accent); padding-left: 0.5rem\`.
+
+### Empty States
+
+Every data-driven section should handle zero-data gracefully.
+Pattern: centered 48px muted icon + descriptive message + optional CTA button.
+
+### Page Transitions
+
+If the theme provides motion tokens, apply the \`entrance-fade\` class to page content containers for smooth page-to-page transitions.
+
+### Navigation Shortcuts
+
+If the essence defines hotkeys or command_palette, implement as keyboard event listeners (useEffect + keydown) \u2014 not as visible UI text.
+
 ### Design Tokens
 
 | Token | Purpose | Use for |
@@ -1583,23 +1619,24 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     writeFileSync(tokensPath, generateTokensCSS(themeData, mode, spatialTokens));
   }
   const treatmentsPath = join(stylesDir, "treatments.css");
-  writeFileSync(treatmentsPath, generateTreatmentCSS(
+  let treatmentCSS = generateTreatmentCSS(
     spatialTokens,
     themeData?.treatments,
     themeData?.decorators,
     themeName
-  ));
+  );
+  const personalityCSS = generatePersonalityCSS(personality || [], themeData || {});
+  treatmentCSS += personalityCSS;
+  writeFileSync(treatmentsPath, treatmentCSS);
   const globalPath = join(stylesDir, "global.css");
   if (!existsSync(globalPath)) {
     writeFileSync(globalPath, generateGlobalCSS(personality));
   }
   const cssFiles = [tokensPath, treatmentsPath, globalPath];
-  const treatmentsMdPath = join(contextDir, "treatments.md");
-  writeFileSync(treatmentsMdPath, generateTreatmentsContext(themeData, themeName));
   const decantrMdPath = join(projectRoot, "DECANTR.md");
   writeFileSync(decantrMdPath, generateDecantrMdV31(guardMode, CSS_APPROACH_CONTENT));
   const hasSections = essence.blueprint.sections && essence.blueprint.sections.length > 0;
-  const contextFiles = [treatmentsMdPath];
+  const contextFiles = [];
   if (!hasSections) {
     const summaryPath = join(contextDir, "essence-summary.md");
     writeFileSync(summaryPath, generateEssenceSummaryV3(essence));
@@ -1729,7 +1766,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
             shellInfoCache[shellId] = {
               description: inner.description || "",
               regions: inner.config?.regions || [],
-              layout: inner.layout || void 0
+              layout: inner.layout || void 0,
+              guidance: inner.guidance || void 0
             };
           }
         } catch {
@@ -1881,7 +1919,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         v30ShellInfo = {
           description: inner.description || "",
           regions: inner.config?.regions || [],
-          layout: inner.layout || void 0
+          layout: inner.layout || void 0,
+          guidance: inner.guidance || void 0
         };
       }
     } catch {
@@ -2015,6 +2054,15 @@ function generateSectionContext(input) {
     }
   }
   lines.push("");
+  if (shellInfo?.guidance && Object.keys(shellInfo.guidance).length > 0) {
+    lines.push(`## Shell Notes (${section.shell})`);
+    lines.push("");
+    for (const [key, value] of Object.entries(shellInfo.guidance)) {
+      const label = key.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+      lines.push(`- **${label}:** ${value}`);
+    }
+    lines.push("");
+  }
   lines.push("---");
   lines.push("");
   lines.push(`**Guard:** ${guardConfig.mode} mode | DNA violations = ${guardConfig.dna_enforcement} | Blueprint violations = ${guardConfig.blueprint_enforcement}`);

package/dist/index.js

@@ -1,2 +1,2 @@
-import "./chunk-D3W3MYKT.js";
-import "./chunk-T7CQSJGV.js";
+import "./chunk-4KKFOXBB.js";
+import "./chunk-MU3657R7.js";

package/dist/{upgrade-TXVD2WIN.js → upgrade-T3FNFFIH.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {

package/src/templates/task-scaffold.md.template

@@ -1,66 +1,12 @@
 # Task Context: Scaffolding
 
-**Enforcement Tier: Creative**
-
-You are scaffolding a new Decantr project. Guard rules are advisory only during initial scaffolding.
-
----
-
-## Your Task
-
-Generate the initial project structure based on the essence specification.
-
-## Rules (Advisory)
-
-During scaffolding, the following rules are recommendations, not requirements:
-
-| # | Layer | Rule | Status | Guidance |
-|---|-------|------|--------|----------|
-| 1 | DNA | Style | Advisory | Use the theme from essence, but creative variations are acceptable |
-| 2 | DNA | Density | Advisory | Follow spacing guidelines loosely |
-| 4 | DNA | Accessibility | Advisory | Meet WCAG level from essence where possible |
-| 5 | DNA | Theme-mode | Advisory | Use the specified theme/mode combination |
-| 6 | Blueprint | Structure | Advisory | Follow the page structure, add placeholder content |
-| 7 | Blueprint | Layout | Advisory | Use suggested patterns, order can be adjusted |
-| 8 | Blueprint | Pattern-exists | Advisory | Use patterns that exist in the registry |
-
-## Checklist
-
-Before scaffolding:
-
-- [ ] Read `decantr.essence.json`
-- [ ] Understand the target framework ({{TARGET}})
-- [ ] Know the theme ({{THEME_STYLE}}) and mode ({{THEME_MODE}})
-- [ ] Review the page structure
-
-During scaffolding:
-
-- [ ] Create the shell layout ({{DEFAULT_SHELL}})
-- [ ] Generate pages from `blueprint.pages[]`
-- [ ] Add pattern placeholders for each page's `layout[]`
-- [ ] Apply theme colors and typography
-- [ ] Set up routing based on page IDs
-
-After scaffolding:
-
-- [ ] Run `npx @decantr/cli validate` to check the essence
-- [ ] Verify each page renders correctly
-- [ ] Check theme consistency across pages
+**Enforcement Tier: Creative** — Guard rules are advisory during initial scaffolding.
 
 ## What to Generate
 
 {{SCAFFOLD_STRUCTURE}}
 
-## Next Steps
-
-After scaffolding is complete:
-
-1. Run the development server
-2. Verify all pages load
-3. Check theme consistency
-4. Run `npx @decantr/cli validate`
-
-Once verified, subsequent changes will use **{{GUARD_MODE}}** enforcement mode.
+Post-scaffold enforcement mode: **{{GUARD_MODE}}**.
 
 ---