@decantr/cli 2.11.0 → 2.13.0

package/dist/{chunk-4SZ4SEKT.js → chunk-MNZKOZW7.js}

@@ -660,8 +660,8 @@ function scanRoutes(projectRoot) {
 }
 
 // src/analyzers/styling.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync3, readdirSync as readdirSync3, readFileSync as readFileSync3, statSync as statSync3 } from "fs";
+import { join as join3, relative as relative3 } from "path";
 var TAILWIND_CONFIGS = [
   "tailwind.config.js",
   "tailwind.config.ts",
@@ -674,8 +674,10 @@ var GLOBALS_CSS_PATHS = [
   "src/styles/global.css",
   "src/styles/globals.css",
   "src/styles/main.css",
+  "src/styles/themes.css",
   "src/styles.css",
   "styles/globals.css",
+  "styles/themes.css",
   "styles.css",
   "assets/css/main.css",
   "src/index.css",
@@ -716,8 +718,15 @@ function extractCSSVariables(content) {
   return { colors, variables };
 }
 function detectDarkMode(projectRoot, cssContents) {
+  const darkSelectors = [
+    /\.dark\b/i,
+    /html\.dark\b/i,
+    /\[data-theme\s*=\s*["']dark["']\]/i,
+    /prefers-color-scheme\s*:\s*dark/i,
+    /color-scheme\s*:\s*dark/i
+  ];
   for (const cssContent of cssContents) {
-    if (cssContent.includes(".dark") || cssContent.includes('[data-theme="dark"]') || cssContent.includes("prefers-color-scheme: dark") || cssContent.includes("color-scheme: dark")) {
+    if (darkSelectors.some((selector) => selector.test(cssContent))) {
       return true;
     }
   }
@@ -763,6 +772,46 @@ function detectDarkMode(projectRoot, cssContents) {
   }
   return false;
 }
+function collectCssFiles(projectRoot) {
+  const seen = /* @__PURE__ */ new Set();
+  const ordered = [];
+  const add = (path) => {
+    if (seen.has(path)) return;
+    if (!existsSync3(join3(projectRoot, path))) return;
+    seen.add(path);
+    ordered.push(path);
+  };
+  for (const rel of GLOBALS_CSS_PATHS) add(rel);
+  for (const rel of DECANTR_STYLE_PATHS) add(rel);
+  const roots = ["src/styles", "styles", "assets/css", "src/app", "app"];
+  const visit = (dir) => {
+    const absolute = join3(projectRoot, dir);
+    if (!existsSync3(absolute)) return;
+    let entries;
+    try {
+      entries = readdirSync3(absolute);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const child = join3(absolute, entry);
+      let stat;
+      try {
+        stat = statSync3(child);
+      } catch {
+        continue;
+      }
+      if (stat.isDirectory()) {
+        if (entry === "node_modules" || entry === ".next" || entry === "dist") continue;
+        visit(relative3(projectRoot, child).replace(/\\/g, "/"));
+      } else if (stat.isFile() && /\.css$/i.test(entry)) {
+        add(relative3(projectRoot, child).replace(/\\/g, "/"));
+      }
+    }
+  };
+  for (const root of roots) visit(root);
+  return ordered.slice(0, 80);
+}
 function scanStyling(projectRoot) {
   let approach = "unknown";
   let configFile;
@@ -811,23 +860,12 @@ function scanStyling(projectRoot) {
     configFile = decantrStyleFiles.join(" + ");
   }
   const cssContents = [];
-  for (const rel of GLOBALS_CSS_PATHS) {
+  const cssFiles = collectCssFiles(projectRoot);
+  for (const rel of cssFiles) {
     const fullPath = join3(projectRoot, rel);
-    if (existsSync3(fullPath)) {
-      try {
-        cssContents.push(readFileSync3(fullPath, "utf-8"));
-      } catch {
-      }
-    }
-  }
-  for (const rel of DECANTR_STYLE_PATHS) {
-    if (GLOBALS_CSS_PATHS.includes(rel)) continue;
-    const fullPath = join3(projectRoot, rel);
-    if (existsSync3(fullPath)) {
-      try {
-        cssContents.push(readFileSync3(fullPath, "utf-8"));
-      } catch {
-      }
+    try {
+      cssContents.push(readFileSync3(fullPath, "utf-8"));
+    } catch {
     }
   }
   let colors = {};
@@ -841,7 +879,7 @@ function scanStyling(projectRoot) {
   const darkMode = detectDarkMode(projectRoot, cssContents);
   if (approach === "unknown" && cssContents.length > 0) {
     approach = "css";
-    configFile = GLOBALS_CSS_PATHS.find((rel) => existsSync3(join3(projectRoot, rel)));
+    configFile = cssFiles[0];
   }
   return {
     approach,
@@ -1045,6 +1083,14 @@ function routeLabel(routes) {
   if (routes.length <= 6) return routes.join(", ");
   return `${routes.slice(0, 6).join(", ")} (+${routes.length - 6} more)`;
 }
+function routePathname(route) {
+  const queryIndex = route.indexOf("?");
+  if (queryIndex === -1) return route;
+  return route.slice(0, queryIndex) || "/";
+}
+function declaredRouteObserved(route, observedRoutes) {
+  return observedRoutes.has(route) || route.includes("?") && observedRoutes.has(routePathname(route));
+}
 function hasDoctrineEffect(essence, key) {
   const effects = essence.dna.constraints?.effects;
   return Boolean(effects && effects[key]);
@@ -1088,7 +1134,9 @@ function scanBrownfieldIssues(projectRoot, essence) {
   const declaredRoutes = essenceRoutes(essence);
   const observedRoutes = new Set(routes.routes.map((route) => route.path));
   const missingFromEssence = [...observedRoutes].filter((route) => !declaredRoutes.has(route));
-  const missingFromSource = [...declaredRoutes].filter((route) => !observedRoutes.has(route));
+  const missingFromSource = [...declaredRoutes].filter(
+    (route) => !declaredRouteObserved(route, observedRoutes)
+  );
   if (routes.routes.length > 0 && declaredRoutes.size === 0) {
     issues.push({
       type: "error",
@@ -1206,11 +1254,11 @@ function scanBrownfieldIssues(projectRoot, essence) {
 }
 
 // src/guard-context.ts
-import { existsSync as existsSync7, readdirSync as readdirSync4, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync5, readFileSync as readFileSync7 } from "fs";
 import { join as join7 } from "path";
 
 // src/bundled-content.ts
-import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync6 } from "fs";
 import { dirname, join as join6 } from "path";
 import { fileURLToPath } from "url";
 function bundledDirCandidates(contentType) {
@@ -1244,7 +1292,7 @@ function loadBundledContentList(contentType) {
   for (const dir of bundledDirCandidates(contentType)) {
     if (!existsSync6(dir)) continue;
     try {
-      for (const file of readdirSync3(dir).filter((name) => name.endsWith(".json"))) {
+      for (const file of readdirSync4(dir).filter((name) => name.endsWith(".json"))) {
         const id = file.replace(/\.json$/, "");
         if (seen.has(id)) continue;
         const path = join6(dir, file);
@@ -1262,7 +1310,7 @@ function loadBundledContentList(contentType) {
 function loadJsonEntries(dir) {
   if (!existsSync7(dir)) return [];
   try {
-    return readdirSync4(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync7(join7(dir, file), "utf-8")));
+    return readdirSync5(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync7(join7(dir, file), "utf-8")));
   } catch {
     return [];
   }
@@ -1307,8 +1355,8 @@ function buildGuardRegistryContext(projectRoot = process.cwd()) {
 }
 
 // src/lib/scan-interactions.ts
-import { existsSync as existsSync8, readdirSync as readdirSync5, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
-import { extname as extname2, join as join8, relative as relative3 } from "path";
+import { existsSync as existsSync8, readdirSync as readdirSync6, readFileSync as readFileSync8, statSync as statSync4 } from "fs";
+import { extname as extname2, join as join8, relative as relative4 } from "path";
 import { verifyInteractionsInSource } from "@decantr/verifier";
 var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".jsx", ".ts", ".js", ".html", ".mdx"]);
 var SKIP_DIRECTORIES = /* @__PURE__ */ new Set([
@@ -1344,7 +1392,7 @@ function walkSourceTree(rootDir) {
   function walk2(dir) {
     let entries;
     try {
-      entries = readdirSync5(dir);
+      entries = readdirSync6(dir);
     } catch {
       return;
     }
@@ -1353,11 +1401,11 @@ function walkSourceTree(rootDir) {
       const fullPath = join8(dir, entry);
       let s;
       try {
-        s = statSync3(fullPath);
+        s = statSync4(fullPath);
       } catch {
         continue;
       }
-      const relativePath = relative3(rootDir, fullPath) || entry;
+      const relativePath = relative4(rootDir, fullPath) || entry;
       if (s.isDirectory()) {
         walk2(fullPath);
       } else if (s.isFile() && SCAN_EXTENSIONS.has(extname2(entry))) {

package/dist/{chunk-IQZCIMQJ.js → chunk-SIDKK73N.js}

@@ -3780,14 +3780,36 @@ This project uses Decantr as a **contract and governance layer only**.
 
 Do not install \`@decantr/css\`, rewrite the styling system, or add generated Decantr CSS files unless the task explicitly changes the adoption mode. Preserve the existing framework styling conventions and map them into the Decantr context before changing implementation files.
 
-Use \`.decantr/context/scaffold-pack.md\` and the matching section/page packs to understand visual intent, shell structure, and route contracts. Implement those contracts through the project's current CSS, component library, tokens, or design-system primitives.`;
+Use \`.decantr/context/scaffold-pack.md\` and the matching section/page packs to understand visual intent, shell structure, and route contracts. Implement those contracts through the project's current CSS, component library, tokens, or design-system primitives.
+
+### Interaction Requirements
+
+Every pattern declares its required interactions in its page-pack \`Interactions\` checklist. A declared interaction must be implemented in source through the project's existing component library, CSS, or event-handler patterns.
+
+| Declared interaction | Canonical implementation shape |
+|----------------------|--------------------------------|
+| \`animate-on-mount\` | Entrance animation class or component transition on the pattern root |
+| \`stagger-children\` | Parent stagger class or animation delay driven by child index |
+| \`keyboard-navigation\` | Arrow-key/Enter/Space handlers with visible focus state |
+| \`ripple-click\` | \`d-ripple\` or an equivalent click feedback class on the interactive surface |`;
 var STYLE_BRIDGE_CSS_APPROACH = `## Styling Adoption
 
 This project uses Decantr in **style-bridge** mode.
 
 Decantr may generate lightweight bridge files such as \`src/styles/tokens.css\` and \`src/styles/decantr-bridge.css\`, but \`@decantr/css\` is not required. Treat these files as a mapping layer between Decantr context and the app's existing styling system.
 
-Preserve the current CSS framework/component library. Use Decantr tokens and bridge classes only where they clarify design intent without replacing the app's established styling conventions.`;
+Preserve the current CSS framework/component library. Use Decantr tokens and bridge classes only where they clarify design intent without replacing the app's established styling conventions.
+
+### Interaction Requirements
+
+Every pattern declares its required interactions in its page-pack \`Interactions\` checklist. A declared interaction must be implemented in source through the project's existing component library, CSS, or event-handler patterns.
+
+| Declared interaction | Canonical implementation shape |
+|----------------------|--------------------------------|
+| \`animate-on-mount\` | Entrance animation class or component transition on the pattern root |
+| \`stagger-children\` | Parent stagger class or animation delay driven by child index |
+| \`keyboard-navigation\` | Arrow-key/Enter/Space handlers with visible focus state |
+| \`ripple-click\` | \`d-ripple\` or an equivalent click feedback class on the interactive surface |`;
 function getCssApproachContent(adoptionMode) {
   if (adoptionMode === "contract-only") return CONTRACT_ONLY_CSS_APPROACH;
   if (adoptionMode === "style-bridge") return STYLE_BRIDGE_CSS_APPROACH;

package/dist/{chunk-NUNUW5IS.js → chunk-YBSBAJ3E.js}

@@ -1,7 +1,7 @@
 import {
   createProjectHealthReport,
   listWorkspaceAppCandidates
-} from "./chunk-5WPRTVNA.js";
+} from "./chunk-3A2DLR47.js";
 
 // src/commands/workspace.ts
 import { execFileSync } from "child_process";

package/dist/{heal-2UCSPRTK.js → heal-IRIDB7IZ.js}

@@ -1,7 +1,7 @@
 import {
   cmdHeal,
   collectCheckIssues
-} from "./chunk-4SZ4SEKT.js";
+} from "./chunk-MNZKOZW7.js";
 export {
   cmdHeal,
   collectCheckIssues

package/dist/{health-ADHNLMX3.js → health-B4W7UJBZ.js}

@@ -10,8 +10,8 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-5WPRTVNA.js";
-import "./chunk-4SZ4SEKT.js";
+} from "./chunk-3A2DLR47.js";
+import "./chunk-MNZKOZW7.js";
 export {
   cmdHealth,
   collectDesignTokenEvidence,

package/dist/index.js

@@ -1,5 +1,5 @@
-import "./chunk-ET4BG746.js";
-import "./chunk-IQZCIMQJ.js";
-import "./chunk-NUNUW5IS.js";
-import "./chunk-5WPRTVNA.js";
-import "./chunk-4SZ4SEKT.js";
+import "./chunk-5MZH6XXQ.js";
+import "./chunk-SIDKK73N.js";
+import "./chunk-YBSBAJ3E.js";
+import "./chunk-3A2DLR47.js";
+import "./chunk-MNZKOZW7.js";

package/dist/{studio-GZFCCVSO.js → studio-JOEECLI6.js}

@@ -1,13 +1,13 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-NUNUW5IS.js";
+} from "./chunk-YBSBAJ3E.js";
 import {
   createProjectHealthReport
-} from "./chunk-5WPRTVNA.js";
+} from "./chunk-3A2DLR47.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry
-} from "./chunk-4SZ4SEKT.js";
+} from "./chunk-MNZKOZW7.js";
 
 // src/commands/studio.ts
 import { readFileSync } from "fs";

package/dist/{upgrade-7ZYWR2GH.js → upgrade-WBFE6EN7.js}

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

package/dist/{workspace-YYCRXJNB.js → workspace-7RU77ZZW.js}

@@ -7,9 +7,9 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-NUNUW5IS.js";
-import "./chunk-5WPRTVNA.js";
-import "./chunk-4SZ4SEKT.js";
+} from "./chunk-YBSBAJ3E.js";
+import "./chunk-3A2DLR47.js";
+import "./chunk-MNZKOZW7.js";
 export {
   cmdWorkspace,
   createWorkspaceHealthReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "keywords": [
     "decantr",
@@ -49,10 +49,10 @@
   "dependencies": {
     "ajv": "^8.20.0",
     "@decantr/core": "2.1.0",
-    "@decantr/telemetry": "2.2.1",
     "@decantr/essence-spec": "2.0.1",
-    "@decantr/verifier": "2.4.0",
-    "@decantr/registry": "2.2.0"
+    "@decantr/telemetry": "2.2.1",
+    "@decantr/registry": "2.2.0",
+    "@decantr/verifier": "2.5.0"
   },
   "scripts": {
     "build": "tsup",