@decantr/cli 1.0.0 → 1.1.0

package/dist/{upgrade-FWICWIQW.js → upgrade-KRFCKUMR.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   RegistryClient
-} from "./chunk-PWTUBGGJ.js";
+} from "./chunk-K6MIDPQH.js";
 import "./chunk-PDX44BCA.js";
 
 // src/commands/upgrade.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {
@@ -22,13 +22,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@decantr/essence-spec": "1.0.0-beta.3",
-    "@decantr/registry": "1.0.0-beta.3"
-  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@decantr/essence-spec": "workspace:*",
+    "@decantr/registry": "workspace:*"
   }
-}
+}

package/src/templates/DECANTR.md.template

@@ -237,6 +237,19 @@ Use the same component variants throughout a pattern. If buttons are `primary` s
 
 ## CSS Implementation
 
+This project uses **@decantr/css** for layout atoms and the generated CSS files for theme tokens and recipe decorators.
+
+### Setup
+
+```javascript
+// 1. Import the atoms runtime
+import { css } from '@decantr/css';
+
+// 2. Import generated CSS files (created by decantr init)
+import './styles/tokens.css';      // Theme tokens (--d-primary, --d-surface, etc.)
+import './styles/decorators.css';  // Recipe decorators ({{THEME_RECIPE}}-card, etc.)
+```
+
 ### HTML Setup
 
 Your `index.html` MUST have theme and mode attributes:
@@ -256,64 +269,51 @@ Your `index.html` MUST have theme and mode attributes:
 - `data-mode` enables light/dark toggle
 - `color-scheme` tells the browser to style native controls (scrollbars, inputs) correctly
 
-### CSS Layer Structure
+### Using Atoms
 
-Use `@layer` for proper cascade control:
+The `css()` function processes atom strings and injects CSS at runtime:
 
-```css
-@layer decantr.reset, decantr.tokens, decantr.decorators, decantr.patterns, decantr.utilities, app;
+```jsx
+// Layout atoms
+<div className={css('_flex _col _gap4 _p4')}>
+  <h1 className={css('_heading1')}>Title</h1>
+  <p className={css('_textsm _fgmuted')}>Description</p>
+</div>
 
-@layer decantr.reset {
-  *, *::before, *::after { box-sizing: border-box; }
-  body { margin: 0; }
-}
+// Responsive prefixes (mobile-first)
+<div className={css('_gc1 _sm:gc2 _lg:gc4')}>
+  {/* 1 col -> 2 cols at 640px -> 4 cols at 1024px */}
+</div>
 
-@layer decantr.tokens {
-  /* Base spacing (theme-agnostic) */
-  :root {
-    --gap1: 4px;
-    --gap2: 8px;
-    --gap3: 12px;
-    --gap4: 16px;
-    --gap6: 24px;
-    --gap8: 32px;
-    --gap12: 48px;
-  }
-
-  /* Theme-specific tokens */
-  html[data-theme="{{THEME_STYLE}}"] {
-    color-scheme: {{THEME_MODE}};
-
-    /* Seed colors from theme */
-    --d-primary: /* from theme.seed.primary */;
-    --d-secondary: /* from theme.seed.secondary */;
-    --d-accent: /* from theme.seed.accent */;
-    --d-bg: /* from theme.seed.background */;
-
-    /* Surface stack */
-    --d-surface: rgba(255, 255, 255, 0.03);
-    --d-surface-raised: rgba(255, 255, 255, 0.06);
-    --d-border: rgba(255, 255, 255, 0.1);
-
-    /* Text hierarchy */
-    --d-text: #FFFFFF;
-    --d-text-secondary: rgba(255, 255, 255, 0.7);
-    --d-text-muted: rgba(255, 255, 255, 0.4);
-  }
-}
+// Pseudo-class prefixes
+<button className={css('_bgprimary _h:bgprimary/80')}>
+  Hover me
+</button>
+```
 
-@layer decantr.decorators {
-  /* Recipe-specific classes from {{THEME_RECIPE}} */
-}
+### Common Atoms
 
-@layer decantr.patterns {
-  .pattern-hero { }
-  .pattern-kpi-grid { }
-}
+| Category | Atoms | Description |
+|----------|-------|-------------|
+| Display | `_flex`, `_grid`, `_block`, `_none` | Display types |
+| Flexbox | `_col`, `_row`, `_wrap`, `_flex1` | Flex direction/behavior |
+| Alignment | `_aic`, `_jcc`, `_jcsb` | Align/justify content |
+| Spacing | `_gap{n}`, `_p{n}`, `_m{n}`, `_px{n}` | Gap, padding, margin |
+| Sizing | `_wfull`, `_hfull`, `_w{n}`, `_h{n}` | Width, height |
+| Typography | `_textsm`, `_textlg`, `_heading1`-`_heading6` | Font sizes |
+| Colors | `_bgprimary`, `_bgsurface`, `_fgmuted` | Background, foreground |
 
-@layer app {
-  /* Your application overrides */
-}
+### CSS Architecture
+
+The CSS is organized into two parts:
+
+1. **Atoms (@decantr/css)** - Layout utilities injected at runtime into `@layer d.atoms`
+2. **Generated CSS files** - Theme tokens and recipe decorators created during scaffold
+
+```
+src/styles/
+  tokens.css      # :root { --d-primary: #...; --d-surface: #...; }
+  decorators.css  # .{{THEME_RECIPE}}-card { ... }
 ```
 
 ### Variable Naming Convention
@@ -321,8 +321,8 @@ Use `@layer` for proper cascade control:
 | Prefix | Purpose | Example |
 |--------|---------|---------|
 | `--d-` | Core Decantr tokens | `--d-primary`, `--d-bg` |
-| `--{recipe}-` | Recipe-specific | `--lum-orb-opacity` |
-| `--gap{N}` | Spacing tokens | `--gap4`, `--gap8` |
+| `--d-gap-{n}` | Spacing tokens | `--d-gap-4`, `--d-gap-8` |
+| `--d-radius` | Border radius | `--d-radius`, `--d-radius-lg` |
 
 ### Theme Switching (JavaScript)
 

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Decantr AI
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/chunk-PWTUBGGJ.js

@@ -1,359 +0,0 @@
-#!/usr/bin/env node
-
-// src/registry.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
-var DEFAULT_API_URL = "https://decantr-registry.fly.dev/v1";
-function getLocalBundledRoot() {
-  return join(__dirname, "bundled");
-}
-function loadFromBundledLocal(contentType, id) {
-  const bundledRoot = getLocalBundledRoot();
-  if (id) {
-    const filePath = join(bundledRoot, contentType, `${id}.json`);
-    if (existsSync(filePath)) {
-      try {
-        const data = JSON.parse(readFileSync(filePath, "utf-8"));
-        return { data, source: { type: "bundled" } };
-      } catch {
-        return null;
-      }
-    }
-    return null;
-  }
-  const dir = join(bundledRoot, contentType);
-  if (!existsSync(dir)) return null;
-  try {
-    const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
-    const items = files.map((f) => {
-      const content = JSON.parse(readFileSync(join(dir, f), "utf-8"));
-      return { id: content.id || f.replace(".json", ""), ...content };
-    });
-    return {
-      data: { items, total: items.length },
-      source: { type: "bundled" }
-    };
-  } catch {
-    return null;
-  }
-}
-async function fetchWithTimeout(url, timeoutMs = 5e3) {
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const response = await fetch(url, { signal: controller.signal });
-    return response;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-async function tryApi(endpoint, apiUrl = DEFAULT_API_URL) {
-  try {
-    const url = `${apiUrl}/${endpoint}`;
-    const response = await fetchWithTimeout(url);
-    if (!response.ok) return null;
-    const data = await response.json();
-    return {
-      data,
-      source: { type: "api", url: apiUrl }
-    };
-  } catch {
-    return null;
-  }
-}
-function loadFromCache(cacheDir, contentType, id) {
-  const cachePath = id ? join(cacheDir, contentType, `${id}.json`) : join(cacheDir, contentType, "index.json");
-  if (!existsSync(cachePath)) return null;
-  try {
-    const data = JSON.parse(readFileSync(cachePath, "utf-8"));
-    return {
-      data,
-      source: { type: "cache" }
-    };
-  } catch {
-    return null;
-  }
-}
-function saveToCache(cacheDir, contentType, id, data) {
-  const dir = join(cacheDir, contentType);
-  mkdirSync(dir, { recursive: true });
-  const cachePath = id ? join(dir, `${id}.json`) : join(dir, "index.json");
-  writeFileSync(cachePath, JSON.stringify(data, null, 2));
-}
-var RegistryClient = class {
-  cacheDir;
-  apiUrl;
-  offline;
-  projectRoot;
-  constructor(options = {}) {
-    this.projectRoot = options.projectRoot || process.cwd();
-    this.cacheDir = options.cacheDir || join(this.projectRoot, ".decantr", "cache");
-    this.apiUrl = options.apiUrl || DEFAULT_API_URL;
-    this.offline = options.offline || false;
-  }
-  /**
-   * Load content from .decantr/custom/{contentType}/{id}.json
-   */
-  loadCustomContent(contentType, id) {
-    const customPath = join(
-      this.projectRoot,
-      ".decantr",
-      "custom",
-      contentType,
-      `${id}.json`
-    );
-    if (!existsSync(customPath)) {
-      return null;
-    }
-    try {
-      const data = JSON.parse(readFileSync(customPath, "utf-8"));
-      return {
-        data,
-        source: { type: "custom", path: customPath }
-      };
-    } catch {
-      return null;
-    }
-  }
-  /**
-   * Fetch archetypes list.
-   */
-  async fetchArchetypes() {
-    if (!this.offline) {
-      const apiResult = await tryApi("archetypes", this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "archetypes", null, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(
-      this.cacheDir,
-      "archetypes"
-    );
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("archetypes");
-    if (bundledResult) return bundledResult;
-    return {
-      data: { items: [], total: 0 },
-      source: { type: "bundled" }
-    };
-  }
-  /**
-   * Fetch a single archetype.
-   */
-  async fetchArchetype(id) {
-    if (!this.offline) {
-      const apiResult = await tryApi(`archetypes/${id}`, this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "archetypes", id, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(this.cacheDir, "archetypes", id);
-    if (cacheResult) return cacheResult;
-    return loadFromBundledLocal("archetypes", id);
-  }
-  /**
-   * Fetch blueprints list.
-   */
-  async fetchBlueprints() {
-    if (!this.offline) {
-      const apiResult = await tryApi("blueprints", this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "blueprints", null, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(
-      this.cacheDir,
-      "blueprints"
-    );
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("blueprints");
-    if (bundledResult) return bundledResult;
-    return {
-      data: { items: [], total: 0 },
-      source: { type: "bundled" }
-    };
-  }
-  /**
-   * Fetch a single blueprint.
-   */
-  async fetchBlueprint(id) {
-    if (!this.offline) {
-      const apiResult = await tryApi(`blueprints/${id}`, this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "blueprints", id, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(this.cacheDir, "blueprints", id);
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("blueprints", id);
-    if (bundledResult) return bundledResult;
-    return loadFromBundledLocal("blueprints", id);
-  }
-  /**
-   * Fetch themes list.
-   */
-  async fetchThemes() {
-    if (!this.offline) {
-      const apiResult = await tryApi("themes", this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "themes", null, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(
-      this.cacheDir,
-      "themes"
-    );
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("themes");
-    if (bundledResult) return bundledResult;
-    return {
-      data: { items: [], total: 0 },
-      source: { type: "bundled" }
-    };
-  }
-  /**
-   * Fetch a single theme.
-   */
-  async fetchTheme(id) {
-    if (id.startsWith("custom:")) {
-      return this.loadCustomContent("themes", id.slice(7));
-    }
-    if (!this.offline) {
-      const apiResult = await tryApi(`themes/${id}`, this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "themes", id, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(this.cacheDir, "themes", id);
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("themes", id);
-    if (bundledResult) return bundledResult;
-    return loadFromBundledLocal("themes", id);
-  }
-  /**
-   * Fetch patterns list.
-   */
-  async fetchPatterns() {
-    if (!this.offline) {
-      const apiResult = await tryApi("patterns", this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "patterns", null, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(
-      this.cacheDir,
-      "patterns"
-    );
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("patterns");
-    if (bundledResult) return bundledResult;
-    return {
-      data: { items: [], total: 0 },
-      source: { type: "bundled" }
-    };
-  }
-  /**
-   * Fetch shells list.
-   */
-  async fetchShells() {
-    if (!this.offline) {
-      const apiResult = await tryApi("shells", this.apiUrl);
-      if (apiResult) {
-        saveToCache(this.cacheDir, "shells", null, apiResult.data);
-        return apiResult;
-      }
-    }
-    const cacheResult = loadFromCache(
-      this.cacheDir,
-      "shells"
-    );
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("shells");
-    if (bundledResult) return bundledResult;
-    const localBundled = loadFromBundledLocal("shells");
-    if (localBundled) return localBundled;
-    return {
-      data: { items: [], total: 0 },
-      source: { type: "bundled" }
-    };
-  }
-  /**
-   * Fetch a single shell.
-   * Note: API only has /shells list endpoint, not /shells/{id}, so we fetch all and filter.
-   */
-  async fetchShell(id) {
-    if (!this.offline) {
-      const apiResult = await tryApi("shells", this.apiUrl);
-      if (apiResult) {
-        const shell = apiResult.data.items.find((s) => s.id === id);
-        if (shell) {
-          saveToCache(this.cacheDir, "shells", id, shell);
-          return { data: shell, source: apiResult.source };
-        }
-      }
-    }
-    const cacheResult = loadFromCache(this.cacheDir, "shells", id);
-    if (cacheResult) return cacheResult;
-    const bundledResult = loadFromBundledLocal("shells", id);
-    if (bundledResult) return bundledResult;
-    return null;
-  }
-  /**
-   * Check if API is available.
-   */
-  async checkApiAvailability() {
-    if (this.offline) return false;
-    try {
-      const response = await fetchWithTimeout(`${this.apiUrl.replace("/v1", "")}/health`, 3e3);
-      return response.ok;
-    } catch {
-      return false;
-    }
-  }
-  /**
-   * Get the source used for the last fetch.
-   */
-  getSourceType() {
-    return this.offline ? "bundled" : "api";
-  }
-};
-async function syncRegistry(cacheDir, apiUrl = DEFAULT_API_URL) {
-  const client = new RegistryClient({ cacheDir, apiUrl, offline: false });
-  const synced = [];
-  const failed = [];
-  const apiAvailable = await client.checkApiAvailability();
-  if (!apiAvailable) {
-    return { synced: [], failed: ["API unavailable"], source: "bundled" };
-  }
-  const types = ["archetypes", "blueprints", "themes", "patterns", "shells"];
-  for (const type of types) {
-    try {
-      const fetchMethod = `fetch${type.charAt(0).toUpperCase()}${type.slice(1)}`;
-      const result = await client[fetchMethod]();
-      if (result.source.type === "api") {
-        synced.push(type);
-      }
-    } catch {
-      failed.push(type);
-    }
-  }
-  return {
-    synced,
-    failed,
-    source: synced.length > 0 ? "api" : "bundled"
-  };
-}
-
-export {
-  RegistryClient,
-  syncRegistry
-};