@decantr/cli 1.5.5 → 1.5.6

package/dist/bin.js

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

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

@@ -9,7 +9,7 @@ import {
   scaffoldMinimal,
   scaffoldProject,
   syncRegistry
-} from "./chunk-MU3657R7.js";
+} from "./chunk-VKWRNLHR.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-T3FNFFIH.js");
+      const { cmdUpgrade } = await import("./upgrade-6MKC6EDQ.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

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

@@ -1081,22 +1081,173 @@ 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'\`
 
-### 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\`, \`_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 |
-| 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\`.
+### Atom Reference
+
+#### Display
+| Atom | CSS |
+|------|-----|
+| \`_flex\` | \`display:flex\` |
+| \`_grid\` | \`display:grid\` |
+| \`_block\` | \`display:block\` |
+| \`_inline\` | \`display:inline\` |
+| \`_inlineflex\` | \`display:inline-flex\` |
+| \`_none\` | \`display:none\` |
+| \`_contents\` | \`display:contents\` |
+
+#### Flexbox
+| Atom | CSS |
+|------|-----|
+| \`_col\` | \`flex-direction:column\` |
+| \`_row\` | \`flex-direction:row\` |
+| \`_colrev\` | \`flex-direction:column-reverse\` |
+| \`_wrap\` | \`flex-wrap:wrap\` |
+| \`_nowrap\` | \`flex-wrap:nowrap\` |
+| \`_flex1\` | \`flex:1\` |
+| \`_flex0\` | \`flex:none\` |
+| \`_flexauto\` | \`flex:auto\` |
+| \`_grow\` | \`flex-grow:1\` |
+| \`_grow0\` | \`flex-grow:0\` |
+| \`_shrink0\` | \`flex-shrink:0\` |
+
+#### Alignment
+| Atom | CSS |
+|------|-----|
+| \`_aic\` | \`align-items:center\` |
+| \`_aifs\` | \`align-items:flex-start\` |
+| \`_aife\` | \`align-items:flex-end\` |
+| \`_aist\` | \`align-items:stretch\` |
+| \`_aibl\` | \`align-items:baseline\` |
+| \`_jcc\` | \`justify-content:center\` |
+| \`_jcfs\` | \`justify-content:flex-start\` |
+| \`_jcfe\` | \`justify-content:flex-end\` |
+| \`_jcsb\` | \`justify-content:space-between\` |
+| \`_jcsa\` | \`justify-content:space-around\` |
+| \`_jcse\` | \`justify-content:space-evenly\` |
+| \`_pic\` | \`place-items:center\` |
+| \`_pcc\` | \`place-content:center\` |
+
+#### Spacing (scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24, ...)
+| Atom | CSS | Notes |
+|------|-----|-------|
+| \`_gap{n}\` | \`gap:{scale}\` | e.g. \`_gap4\` = \`gap:1rem\` |
+| \`_gx{n}\` | \`column-gap:{scale}\` | horizontal gap |
+| \`_gy{n}\` | \`row-gap:{scale}\` | vertical gap |
+| \`_p{n}\` | \`padding:{scale}\` | all sides |
+| \`_pt{n}\`, \`_pr{n}\`, \`_pb{n}\`, \`_pl{n}\` | directional padding | top/right/bottom/left |
+| \`_px{n}\` | \`padding-inline:{scale}\` | horizontal |
+| \`_py{n}\` | \`padding-block:{scale}\` | vertical |
+| \`_m{n}\` | \`margin:{scale}\` | same as padding variants |
+| \`_mx{n}\`, \`_my{n}\` | inline/block margin | horizontal/vertical |
+
+#### Sizing
+| Atom | CSS |
+|------|-----|
+| \`_wfull\` / \`_w100\` | \`width:100%\` |
+| \`_hfull\` / \`_h100\` | \`height:100%\` |
+| \`_wscreen\` | \`width:100vw\` |
+| \`_hscreen\` | \`height:100vh\` |
+| \`_wfit\` | \`width:fit-content\` |
+| \`_hfit\` | \`height:fit-content\` |
+| \`_wauto\` | \`width:auto\` |
+| \`_minw0\` | \`min-width:0\` |
+| \`_minh0\` | \`min-height:0\` |
+| \`_w{n}\`, \`_h{n}\` | width/height from spacing scale |
+| \`_minw{n}\`, \`_maxw{n}\` | min/max width from scale |
+
+#### Text Size
+| Atom | Size | Line-height |
+|------|------|-------------|
+| \`_textxs\` | 0.75rem | 1rem |
+| \`_textsm\` | 0.875rem | 1.25rem |
+| \`_textbase\` | 1rem | 1.5rem |
+| \`_textlg\` | 1.125rem | 1.75rem |
+| \`_textxl\` | 1.25rem | 1.75rem |
+| \`_text2xl\` | 1.5rem | 2rem |
+| \`_text3xl\` | 1.875rem | 2.25rem |
+| \`_heading1\`-\`_heading6\` | Heading presets (size + weight) |
+
+#### Text Style
+| Atom | CSS |
+|------|-----|
+| \`_fontbold\` | \`font-weight:700\` |
+| \`_fontsemi\` | \`font-weight:600\` |
+| \`_fontmedium\` | \`font-weight:500\` |
+| \`_fontlight\` | \`font-weight:300\` |
+| \`_italic\` | \`font-style:italic\` |
+| \`_underline\` | \`text-decoration:underline\` |
+| \`_uppercase\` | \`text-transform:uppercase\` |
+| \`_truncate\` | overflow ellipsis + nowrap |
+| \`_textl\`, \`_textc\`, \`_textr\` | text-align left/center/right |
+
+#### Color (theme variable based)
+| Atom | CSS |
+|------|-----|
+| \`_bgprimary\` | \`background:var(--d-primary)\` |
+| \`_bgsurface\` | \`background:var(--d-surface)\` |
+| \`_bgsurface0\`-\`_bgsurface2\` | surface elevation layers |
+| \`_bgmuted\` | \`background:var(--d-muted)\` |
+| \`_bgbg\` | \`background:var(--d-bg)\` |
+| \`_bgsuccess\`, \`_bgerror\`, \`_bgwarning\`, \`_bginfo\` | status backgrounds |
+| \`_fgprimary\` | \`color:var(--d-primary)\` |
+| \`_fgtext\` | \`color:var(--d-text)\` |
+| \`_fgmuted\` | \`color:var(--d-text-muted)\` |
+| \`_fgsuccess\`, \`_fgerror\`, \`_fgwarning\`, \`_fginfo\` | status text |
+| \`_bcborder\` | \`border-color:var(--d-border)\` |
+
+#### Overflow & Whitespace
+| Atom | CSS |
+|------|-----|
+| \`_overhidden\` | \`overflow:hidden\` |
+| \`_overauto\` | \`overflow:auto\` |
+| \`_overscroll\` | \`overflow:scroll\` |
+| \`_overxauto\`, \`_overyauto\` | axis-specific overflow |
+| \`_nowraptext\` | \`white-space:nowrap\` |
+| \`_prewrap\` | \`white-space:pre-wrap\` |
+| \`_breakword\` | \`overflow-wrap:break-word\` |
+
+#### Cursor & Interaction
+| Atom | CSS |
+|------|-----|
+| \`_pointer\` | \`cursor:pointer\` |
+| \`_cursordefault\` | \`cursor:default\` |
+| \`_notallowed\` | \`cursor:not-allowed\` |
+| \`_grab\` | \`cursor:grab\` |
+| \`_selectnone\` | \`user-select:none\` |
+| \`_ptrnone\` | \`pointer-events:none\` |
+
+#### Position & Layout
+| Atom | CSS |
+|------|-----|
+| \`_rel\` | \`position:relative\` |
+| \`_abs\` | \`position:absolute\` |
+| \`_fixed\` | \`position:fixed\` |
+| \`_sticky\` | \`position:sticky\` |
+| \`_inset0\` | \`inset:0\` |
+| \`_top0\`, \`_right0\`, \`_bottom0\`, \`_left0\` | edge positioning |
+| \`_z10\`-\`_z50\` | z-index scale |
+
+#### Grid
+| Atom | CSS |
+|------|-----|
+| \`_gc1\`-\`_gc12\` | \`grid-template-columns:repeat(N,...)\` |
+| \`_gr1\`-\`_gr6\` | \`grid-template-rows:repeat(N,...)\` |
+| \`_span1\`-\`_span12\`, \`_spanfull\` | column span |
+| \`_rowspan1\`-\`_rowspan6\` | row span |
+
+#### Visual
+| Atom | CSS |
+|------|-----|
+| \`_rounded\` | \`border-radius:var(--d-radius)\` |
+| \`_roundedfull\` | \`border-radius:9999px\` |
+| \`_roundedsm\`, \`_roundedlg\`, \`_roundedxl\` | radius variants |
+| \`_shadow\`, \`_shadowmd\`, \`_shadowlg\` | box-shadow presets |
+| \`_bordernone\` | \`border:none\` |
+| \`_bw{n}\` | \`border-width:{n}px\` |
+| \`_op0\`-\`_op100\` | opacity (0, 25, 50, 75, 100) |
+| \`_trans\` | \`transition:all 0.15s ease\` |
+| \`_visible\`, \`_invisible\` | visibility |
+
+Responsive prefixes: \`_sm:\`, \`_md:\`, \`_lg:\` (e.g. \`_md:gc2\`, \`_lg:gc4\`, \`_sm:flex\`).
 
 ### Section Labels
 
@@ -1685,7 +1836,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
                   const spec = {
                     description: inner.description || "",
                     components: inner.components || [],
-                    slots
+                    slots,
+                    layout_hints: inner.layout_hints
                   };
                   if (!spec.components || spec.components.length === 0) {
                     const syntheticComps = generateSyntheticComponents(name, spec.description);
@@ -1865,7 +2017,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
                 const spec = {
                   description: inner.description || "",
                   components: inner.components || [],
-                  slots
+                  slots,
+                  layout_hints: inner.layout_hints
                 };
                 if (!spec.components || spec.components.length === 0) {
                   const syntheticComps = generateSyntheticComponents(name, spec.description);
@@ -2087,6 +2240,10 @@ function generateSectionContext(input) {
     }
     lines.push("");
   }
+  const themePrefix = themeName.split("-")[0] || themeName;
+  lines.push("");
+  lines.push(`Usage: \`className={css('_flex _col _gap4') + ' d-surface ${themePrefix}-glass'}\` \u2014 atoms via css(), treatments and theme decorators as plain class strings.`);
+  lines.push("");
   lines.push("---");
   lines.push("");
   if (zoneContext) {
@@ -2139,6 +2296,12 @@ function generateSectionContext(input) {
       for (const [slot, desc] of Object.entries(spec.slots)) {
         lines.push(`- \`${slot}\`: ${desc}`);
       }
+      if (spec.layout_hints && Object.keys(spec.layout_hints).length > 0) {
+        lines.push(`  **Layout guidance:**`);
+        for (const [key, value] of Object.entries(spec.layout_hints)) {
+          lines.push(`  - ${key}: ${value}`);
+        }
+      }
       lines.push("");
     }
     lines.push("---");

package/dist/index.js

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

package/dist/{upgrade-T3FNFFIH.js → upgrade-6MKC6EDQ.js}

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

package/package.json

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