rafters 0.0.52 → 0.0.54

package/dist/index.js

@@ -241,6 +241,18 @@ var registryClient = new RegistryClient();
 import { existsSync } from "fs";
 import { readFile } from "fs/promises";
 import { join } from "path";
+var SELECTABLE_FRAMEWORKS = [
+  "next",
+  "vite",
+  "remix",
+  "react-router",
+  "astro",
+  "wc",
+  "vanilla"
+];
+function isSelectableFramework(value2) {
+  return SELECTABLE_FRAMEWORKS.includes(value2);
+}
 var CONFIG_FILE_FRAMEWORKS = [
   { files: ["astro.config.mjs", "astro.config.ts", "astro.config.js"], framework: "astro" },
   { files: ["next.config.mjs", "next.config.ts", "next.config.js"], framework: "next" },
@@ -313,6 +325,7 @@ async function detectShadcn(cwd) {
 }
 function frameworkToTarget(framework) {
   if (framework === "astro") return "astro";
+  if (framework === "wc") return "wc";
   return "react";
 }
 function targetToExtension(target) {
@@ -320,7 +333,8 @@ function targetToExtension(target) {
     react: ".tsx",
     astro: ".astro",
     vue: ".vue",
-    svelte: ".svelte"
+    svelte: ".svelte",
+    wc: ".element.ts"
   };
   return map[target];
 }
@@ -849,7 +863,8 @@ async function installRegistryDependencies(items, targetDir, options = {}) {
 }
 
 // src/utils/paths.ts
-import { join as join3 } from "path";
+import { realpathSync } from "fs";
+import { isAbsolute, join as join3, relative, resolve } from "path";
 function getRaftersPaths(projectRoot = process.cwd()) {
   const root = join3(projectRoot, ".rafters");
   return {
@@ -860,6 +875,63 @@ function getRaftersPaths(projectRoot = process.cwd()) {
     importPending: join3(root, "import-pending.json")
   };
 }
+var PathEntrySchema = external_exports.union([
+  external_exports.string(),
+  external_exports.object({ path: external_exports.string(), root: external_exports.literal(true).optional() })
+]);
+var PathFieldSchema = external_exports.union([external_exports.string(), external_exports.array(PathEntrySchema)]);
+function entryPath(entry) {
+  return typeof entry === "string" ? entry : entry.path;
+}
+function entryHasExplicitRoot(entry) {
+  return typeof entry === "object" && entry.root === true;
+}
+function tryRealpath(absPath) {
+  try {
+    return realpathSync(absPath);
+  } catch {
+    return absPath;
+  }
+}
+function isInsideCwd(absPath, cwdReal) {
+  const rel = relative(cwdReal, absPath);
+  return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
+}
+function resolveRoot(field, cwd, fallback) {
+  const cwdReal = tryRealpath(resolve(cwd));
+  if (typeof field === "string") {
+    return field;
+  }
+  for (const entry of field) {
+    if (entryHasExplicitRoot(entry)) {
+      return entryPath(entry);
+    }
+  }
+  for (const entry of field) {
+    const p2 = entryPath(entry);
+    const abs = isAbsolute(p2) ? p2 : resolve(cwdReal, p2);
+    if (isInsideCwd(tryRealpath(abs), cwdReal)) return p2;
+  }
+  return fallback;
+}
+function resolveReadSet(field, cwd, fallback) {
+  const cwdReal = tryRealpath(resolve(cwd));
+  const entries = typeof field === "string" ? [field] : field.map(entryPath);
+  const root = resolveRoot(field, cwd, fallback ?? entries[0] ?? "");
+  const ordered = [root, ...entries.filter((e) => e !== root)];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const entry of ordered) {
+    if (!entry) continue;
+    const abs = isAbsolute(entry) ? entry : resolve(cwdReal, entry);
+    const real = tryRealpath(abs);
+    if (!seen.has(real)) {
+      seen.add(real);
+      out.push(real);
+    }
+  }
+  return out;
+}
 
 // src/commands/add.ts
 async function isInitialized(cwd) {
@@ -935,50 +1007,45 @@ function isAlreadyInstalled(config2, item) {
 }
 function trackInstalled(config2, items) {
   if (!config2.installed) {
-    config2.installed = { components: [], primitives: [], composites: [] };
-  }
-  if (!config2.installed.composites) {
-    config2.installed.composites = [];
+    config2.installed = { components: [], primitives: [], composites: [], rules: [] };
   }
+  const installed = config2.installed;
+  if (!installed.composites) installed.composites = [];
+  if (!installed.rules) installed.rules = [];
   for (const item of items) {
-    if (item.type === "ui") {
-      if (!config2.installed.components.includes(item.name)) {
-        config2.installed.components.push(item.name);
-      }
-    } else if (item.type === "composite") {
-      if (!config2.installed.composites.includes(item.name)) {
-        config2.installed.composites.push(item.name);
-      }
-    } else {
-      if (!config2.installed.primitives.includes(item.name)) {
-        config2.installed.primitives.push(item.name);
-      }
-    }
+    const bucket = item.type === "ui" ? installed.components : item.type === "composite" ? installed.composites : installed.primitives;
+    if (!bucket.includes(item.name)) bucket.push(item.name);
   }
-  config2.installed.components.sort();
-  config2.installed.primitives.sort();
-  config2.installed.composites.sort();
+  installed.components.sort();
+  installed.primitives.sort();
+  installed.composites.sort();
+  installed.rules.sort();
+}
+function rootFor(field, cwd, fallback) {
+  return field === void 0 ? fallback : resolveRoot(field, cwd, fallback);
 }
-function transformPath(registryPath, config2) {
+function transformPath(registryPath, config2, cwd) {
   if (!config2) return registryPath;
-  if (registryPath.startsWith("components/ui/")) {
-    return registryPath.replace("components/ui/", `${config2.componentsPath}/`);
-  }
-  if (registryPath.startsWith("lib/primitives/")) {
-    return registryPath.replace("lib/primitives/", `${config2.primitivesPath}/`);
-  }
-  if (registryPath.startsWith("composites/")) {
-    return registryPath.replace("composites/", `${config2.compositesPath}/`);
+  const replacements = [
+    ["components/ui/", config2.componentsPath, "components/ui"],
+    ["lib/primitives/", config2.primitivesPath, "lib/primitives"],
+    ["composites/", config2.compositesPath, "composites"],
+    ["rules/", config2.rulesPath, "rules"]
+  ];
+  for (const [prefix, field, fallback] of replacements) {
+    if (registryPath.startsWith(prefix)) {
+      return registryPath.replace(prefix, `${rootFor(field, cwd, fallback)}/`);
+    }
   }
   return registryPath;
 }
 function fileExists(cwd, relativePath) {
   return existsSync2(join4(cwd, relativePath));
 }
-function transformFileContent(content, config2, fileType = "component") {
+function transformFileContent(content, config2, fileType = "component", cwd = process.cwd()) {
   let transformed = content;
-  const componentsPath = config2?.componentsPath ?? "components/ui";
-  const primitivesPath = config2?.primitivesPath ?? "lib/primitives";
+  const componentsPath = rootFor(config2?.componentsPath, cwd, "components/ui");
+  const primitivesPath = rootFor(config2?.primitivesPath, cwd, "lib/primitives");
   const stripSourceRoot = (p2) => p2.replace(/^(src|app)\//, "");
   const aliasComponents = stripSourceRoot(componentsPath);
   const aliasPrimitives = stripSourceRoot(primitivesPath);
@@ -1027,7 +1094,7 @@ async function installItem(cwd, item, options, config2) {
     }
   }
   for (const file of filesToInstall) {
-    const projectPath2 = transformPath(file.path, config2);
+    const projectPath2 = transformPath(file.path, config2, cwd);
     const targetPath = join4(cwd, projectPath2);
     if (fileExists(cwd, projectPath2)) {
       if (!options.overwrite) {
@@ -1043,7 +1110,7 @@ async function installItem(cwd, item, options, config2) {
     }
     await mkdir(dirname(targetPath), { recursive: true });
     const fileType = item.type === "primitive" ? "primitive" : "component";
-    const transformedContent = transformFileContent(file.content, config2, fileType);
+    const transformedContent = transformFileContent(file.content, config2, fileType, cwd);
     await writeFile(targetPath, transformedContent, "utf-8");
     installedFiles.push(projectPath2);
   }
@@ -1228,10 +1295,11 @@ async function add(componentArgs, options) {
       componentsPath: "components/ui",
       primitivesPath: "lib/primitives",
       compositesPath: "composites",
+      rulesPath: "rules",
       cssPath: null,
       shadcn: false,
       exports: DEFAULT_EXPORTS,
-      installed: { components: [], primitives: [], composites: [] }
+      installed: { components: [], primitives: [], composites: [], rules: [] }
     };
     trackInstalled(newConfig, installedItems);
     await saveConfig(cwd, newConfig);
@@ -1256,7 +1324,7 @@ async function add(componentArgs, options) {
 // src/commands/import.ts
 import { existsSync as existsSync3 } from "fs";
 import { rename as rename2 } from "fs/promises";
-import { relative as relative2 } from "path";
+import { relative as relative3 } from "path";
 
 // src/onboard/importers/generic-css.ts
 import { readFile as readFile4 } from "fs/promises";
@@ -2148,13 +2216,13 @@ async function previewOnboard(projectPath2) {
 
 // src/onboard/writer.ts
 import { mkdir as mkdir2, rename, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname2, relative } from "path";
+import { dirname as dirname2, relative as relative2 } from "path";
 function toImportPending(result, projectRoot, now = /* @__PURE__ */ new Date()) {
   if (!result.source) {
     throw new Error("Cannot build ImportPending from a failed onboard result");
   }
   const [primarySource, ...additionalSources] = result.sourcePaths.map(
-    (p2) => relative(projectRoot, p2)
+    (p2) => relative2(projectRoot, p2)
   );
   const tokens = result.tokens.map((token) => {
     if (typeof token.value !== "string") {
@@ -2220,7 +2288,7 @@ async function importCommand(options) {
     if (!options.force) {
       log({
         event: "import:pending_exists",
-        path: relative2(cwd, paths.importPending),
+        path: relative3(cwd, paths.importPending),
         message: "An import-pending.json already exists. Use --force to overwrite (previous file will be backed up)."
       });
       process.exitCode = 1;
@@ -2230,7 +2298,7 @@ async function importCommand(options) {
     await rename2(paths.importPending, backupPath);
     log({
       event: "import:pending_backed_up",
-      backup: relative2(cwd, backupPath)
+      backup: relative3(cwd, backupPath)
     });
   }
   log({ event: "import:scanning" });
@@ -2258,7 +2326,7 @@ async function importCommand(options) {
   await writeImportPending(paths.importPending, doc);
   log({
     event: "import:complete",
-    path: relative2(cwd, paths.importPending),
+    path: relative3(cwd, paths.importPending),
     source: result.source,
     confidence: result.confidence,
     tokensCreated: result.stats.tokensCreated,
@@ -2271,7 +2339,7 @@ async function importCommand(options) {
 import { existsSync as existsSync4 } from "fs";
 import { copyFile, mkdir as mkdir4, readFile as readFile8, rm, writeFile as writeFile4 } from "fs/promises";
 import { createRequire } from "module";
-import { join as join10, relative as relative3 } from "path";
+import { join as join10, relative as relative4 } from "path";
 import { checkbox, confirm, select } from "@inquirer/prompts";
 
 // ../design-tokens/src/dependencies.ts
@@ -7100,8 +7168,8 @@ var require_util = __commonJS({
       }
       function fn() {
         var promiseResolve, promiseReject;
-        var promise = new Promise(function(resolve8, reject) {
-          promiseResolve = resolve8;
+        var promise = new Promise(function(resolve9, reject) {
+          promiseResolve = resolve9;
           promiseReject = reject;
         });
         var args = [];
@@ -10247,7 +10315,7 @@ var require_path = __commonJS({
         } else if (!path2) {
           continue;
         }
-        var result = win32StatPath(path2), device = result.device, isUnc = result.isUnc, isAbsolute = result.isAbsolute, tail = result.tail;
+        var result = win32StatPath(path2), device = result.device, isUnc = result.isUnc, isAbsolute2 = result.isAbsolute, tail = result.tail;
         if (device && resolvedDevice && device.toLowerCase() !== resolvedDevice.toLowerCase()) {
           continue;
         }
@@ -10256,7 +10324,7 @@ var require_path = __commonJS({
         }
         if (!resolvedAbsolute) {
           resolvedTail = tail + "\\" + resolvedTail;
-          resolvedAbsolute = isAbsolute;
+          resolvedAbsolute = isAbsolute2;
         }
         if (resolvedDevice && resolvedAbsolute) {
           break;
@@ -10272,9 +10340,9 @@ var require_path = __commonJS({
       return resolvedDevice + (resolvedAbsolute ? "\\" : "") + resolvedTail || ".";
     };
     win323.normalize = function(path2) {
-      var result = win32StatPath(path2), device = result.device, isUnc = result.isUnc, isAbsolute = result.isAbsolute, tail = result.tail, trailingSlash = /[\\\/]$/.test(tail);
-      tail = normalizeArray(tail.split(/[\\\/]+/), !isAbsolute).join("\\");
-      if (!tail && !isAbsolute) {
+      var result = win32StatPath(path2), device = result.device, isUnc = result.isUnc, isAbsolute2 = result.isAbsolute, tail = result.tail, trailingSlash = /[\\\/]$/.test(tail);
+      tail = normalizeArray(tail.split(/[\\\/]+/), !isAbsolute2).join("\\");
+      if (!tail && !isAbsolute2) {
         tail = ".";
       }
       if (tail && trailingSlash) {
@@ -10283,7 +10351,7 @@ var require_path = __commonJS({
       if (isUnc) {
         device = normalizeUNCRoot(device);
       }
-      return device + (isAbsolute ? "\\" : "") + tail;
+      return device + (isAbsolute2 ? "\\" : "") + tail;
     };
     win323.isAbsolute = function(path2) {
       return win32StatPath(path2).isAbsolute;
@@ -10431,15 +10499,15 @@ var require_path = __commonJS({
       return (resolvedAbsolute ? "/" : "") + resolvedPath || ".";
     };
     posix3.normalize = function(path2) {
-      var isAbsolute = posix3.isAbsolute(path2), trailingSlash = path2 && path2[path2.length - 1] === "/";
-      path2 = normalizeArray(path2.split("/"), !isAbsolute).join("/");
-      if (!path2 && !isAbsolute) {
+      var isAbsolute2 = posix3.isAbsolute(path2), trailingSlash = path2 && path2[path2.length - 1] === "/";
+      path2 = normalizeArray(path2.split("/"), !isAbsolute2).join("/");
+      if (!path2 && !isAbsolute2) {
         path2 = ".";
       }
       if (path2 && trailingSlash) {
         path2 += "/";
       }
-      return (isAbsolute ? "/" : "") + path2;
+      return (isAbsolute2 ? "/" : "") + path2;
     };
     posix3.isAbsolute = function(path2) {
       return path2.charAt(0) === "/";
@@ -11065,7 +11133,7 @@ var require_events = __commonJS({
       return ret;
     }
     function once(emitter, name2) {
-      return new Promise(function(resolve8, reject) {
+      return new Promise(function(resolve9, reject) {
         function errorListener(err) {
           emitter.removeListener(name2, resolver);
           reject(err);
@@ -11074,7 +11142,7 @@ var require_events = __commonJS({
           if (typeof emitter.removeListener === "function") {
             emitter.removeListener("error", errorListener);
           }
-          resolve8([].slice.call(arguments));
+          resolve9([].slice.call(arguments));
         }
         ;
         eventTargetAgnosticAddListener(emitter, name2, resolver, { once: true });
@@ -11784,11 +11852,11 @@ var require_util3 = __commonJS({
     var queueMicrotask_1 = require_queueMicrotask();
     exports.isWin = process2.platform === "win32";
     function promisify(fs22, fn, getResult = (input) => input) {
-      return (...args) => new Promise((resolve8, reject) => {
+      return (...args) => new Promise((resolve9, reject) => {
         fs22[fn].bind(fs22)(...args, (error3, result) => {
           if (error3)
             return reject(error3);
-          return resolve8(getResult(result));
+          return resolve9(getResult(result));
         });
       });
     }
@@ -11944,9 +12012,9 @@ var require_util3 = __commonJS({
     }
     function streamToBuffer(stream2) {
       const chunks = [];
-      return new Promise((resolve8, reject) => {
+      return new Promise((resolve9, reject) => {
         stream2.on("data", (chunk) => chunks.push(chunk));
-        stream2.on("end", () => resolve8(buffer_1.Buffer.concat(chunks)));
+        stream2.on("end", () => resolve9(buffer_1.Buffer.concat(chunks)));
         stream2.on("error", reject);
       });
     }
@@ -12327,11 +12395,11 @@ function __metadata(metadataKey, metadataValue) {
 }
 function __awaiter(thisArg, _arguments, P, generator) {
   function adopt(value2) {
-    return value2 instanceof P ? value2 : new P(function(resolve8) {
-      resolve8(value2);
+    return value2 instanceof P ? value2 : new P(function(resolve9) {
+      resolve9(value2);
     });
   }
-  return new (P || (P = Promise))(function(resolve8, reject) {
+  return new (P || (P = Promise))(function(resolve9, reject) {
     function fulfilled(value2) {
       try {
         step(generator.next(value2));
@@ -12347,7 +12415,7 @@ function __awaiter(thisArg, _arguments, P, generator) {
       }
     }
     function step(result) {
-      result.done ? resolve8(result.value) : adopt(result.value).then(fulfilled, rejected);
+      result.done ? resolve9(result.value) : adopt(result.value).then(fulfilled, rejected);
     }
     step((generator = generator.apply(thisArg, _arguments || [])).next());
   });
@@ -12530,14 +12598,14 @@ function __asyncValues(o) {
   }, i);
   function verb(n2) {
     i[n2] = o[n2] && function(v) {
-      return new Promise(function(resolve8, reject) {
-        v = o[n2](v), settle(resolve8, reject, v.done, v.value);
+      return new Promise(function(resolve9, reject) {
+        v = o[n2](v), settle(resolve9, reject, v.done, v.value);
       });
     };
   }
-  function settle(resolve8, reject, d2, v) {
+  function settle(resolve9, reject, d2, v) {
     Promise.resolve(v).then(function(v2) {
-      resolve8({ value: v2, done: d2 });
+      resolve9({ value: v2, done: d2 });
     }, reject);
   }
 }
@@ -12955,12 +13023,12 @@ var require_Dir = __commonJS({
         return typeof x === "function";
       }
       promisify(obj, fn) {
-        return (...args) => new Promise((resolve8, reject) => {
+        return (...args) => new Promise((resolve9, reject) => {
           if (this.isFunction(obj[fn])) {
             obj[fn].bind(obj)(...args, (error3, result) => {
               if (error3)
                 reject(error3);
-              resolve8(result);
+              resolve9(result);
             });
           } else {
             reject("Not a function");
@@ -13084,7 +13152,7 @@ var require_volume = __commonJS({
     var Dir_1 = require_Dir();
     var resolveCrossPlatform = pathModule.resolve;
     var { O_RDONLY, O_WRONLY, O_RDWR, O_CREAT, O_EXCL, O_TRUNC, O_APPEND, O_DIRECTORY, O_SYMLINK, F_OK, COPYFILE_EXCL, COPYFILE_FICLONE_FORCE } = constants_1.constants;
-    var { sep: sep2, relative: relative4, join: join16, dirname: dirname6 } = pathModule.posix ? pathModule.posix : pathModule;
+    var { sep: sep2, relative: relative5, join: join16, dirname: dirname6 } = pathModule.posix ? pathModule.posix : pathModule;
     var kMinPoolSpace = 128;
     var EPERM = "EPERM";
     var ENOENT2 = "ENOENT";
@@ -13099,13 +13167,13 @@ var require_volume = __commonJS({
     var ENOSYS = "ENOSYS";
     var ERR_FS_EISDIR = "ERR_FS_EISDIR";
     var ERR_OUT_OF_RANGE = "ERR_OUT_OF_RANGE";
-    var resolve8 = (filename, base = process_1.default.cwd()) => resolveCrossPlatform(base, filename);
+    var resolve9 = (filename, base = process_1.default.cwd()) => resolveCrossPlatform(base, filename);
     if (util_1.isWin) {
-      const _resolve = resolve8;
-      resolve8 = (filename, base) => (0, util_1.unixify)(_resolve(filename, base));
+      const _resolve = resolve9;
+      resolve9 = (filename, base) => (0, util_1.unixify)(_resolve(filename, base));
     }
     function filenameToSteps(filename, base) {
-      const fullPath = resolve8(filename, base);
+      const fullPath = resolve9(filename, base);
       const fullPathSansSlash = fullPath.substring(1);
       if (!fullPathSansSlash)
         return [];
@@ -13427,7 +13495,7 @@ var require_volume = __commonJS({
           if (node.isFile()) {
             let filename = child.getPath();
             if (path2)
-              filename = relative4(path2, filename);
+              filename = relative5(path2, filename);
             json2[filename] = asBuffer ? node.getBuffer() : node.getString();
           } else if (node.isDirectory()) {
             this._toJSON(child, json2, path2, asBuffer);
@@ -13435,7 +13503,7 @@ var require_volume = __commonJS({
         }
         let dirPath = link.getPath();
         if (path2)
-          dirPath = relative4(path2, dirPath);
+          dirPath = relative5(path2, dirPath);
         if (dirPath && isEmpty) {
           json2[dirPath] = null;
         }
@@ -13466,7 +13534,7 @@ var require_volume = __commonJS({
       fromJSON(json2, cwd = process_1.default.cwd()) {
         for (let filename in json2) {
           const data = json2[filename];
-          filename = resolve8(filename, cwd);
+          filename = resolve9(filename, cwd);
           if (typeof data === "string" || data instanceof buffer_1.Buffer) {
             const dir = dirname6(filename);
             this.mkdirpBase(
@@ -14913,7 +14981,7 @@ var require_volume = __commonJS({
           const filepath = link.getPath();
           const node = link.getNode();
           const onNodeChange = () => {
-            let filename = relative4(this._filename, filepath);
+            let filename = relative5(this._filename, filepath);
             if (!filename) {
               filename = this._getName();
             }
@@ -14928,7 +14996,7 @@ var require_volume = __commonJS({
           var _a;
           const node = link.getNode();
           const onLinkChildAdd = (l) => {
-            this.emit("change", "rename", relative4(this._filename, l.getPath()));
+            this.emit("change", "rename", relative5(this._filename, l.getPath()));
             setTimeout(() => {
               watchLinkNodeChanged(l);
               watchLinkChildrenChanged(l);
@@ -14949,7 +15017,7 @@ var require_volume = __commonJS({
               }
             };
             removeLinkNodeListeners(l);
-            this.emit("change", "rename", relative4(this._filename, l.getPath()));
+            this.emit("change", "rename", relative5(this._filename, l.getPath()));
           };
           for (const [name2, childLink] of link.children.entries()) {
             if (childLink && name2 !== "." && name2 !== "..") {
@@ -15416,15 +15484,15 @@ function winResolve(...args) {
     const len = path2.length;
     let rootEnd = 0;
     let device = "";
-    let isAbsolute = false;
+    let isAbsolute2 = false;
     const code = path2.charCodeAt(0);
     if (len === 1) {
       if (isPathSeparator(code)) {
         rootEnd = 1;
-        isAbsolute = true;
+        isAbsolute2 = true;
       }
     } else if (isPathSeparator(code)) {
-      isAbsolute = true;
+      isAbsolute2 = true;
       if (isPathSeparator(path2.charCodeAt(1))) {
         let j = 2;
         let last2 = j;
@@ -15455,7 +15523,7 @@ function winResolve(...args) {
       device = path2.slice(0, 2);
       rootEnd = 2;
       if (len > 2 && isPathSeparator(path2.charCodeAt(2))) {
-        isAbsolute = true;
+        isAbsolute2 = true;
         rootEnd = 3;
       }
     }
@@ -15471,8 +15539,8 @@ function winResolve(...args) {
       if (resolvedDevice.length > 0) break;
     } else {
       resolvedTail = `${path2.slice(rootEnd)}\\${resolvedTail}`;
-      resolvedAbsolute = isAbsolute;
-      if (isAbsolute && resolvedDevice.length > 0) {
+      resolvedAbsolute = isAbsolute2;
+      if (isAbsolute2 && resolvedDevice.length > 0) {
         break;
       }
     }
@@ -15486,13 +15554,13 @@ function winNormalize(path2) {
   if (len === 0) return ".";
   let rootEnd = 0;
   let device;
-  let isAbsolute = false;
+  let isAbsolute2 = false;
   const code = path2.charCodeAt(0);
   if (len === 1) {
     return isPosixPathSeparator(code) ? "\\" : path2;
   }
   if (isPathSeparator(code)) {
-    isAbsolute = true;
+    isAbsolute2 = true;
     if (isPathSeparator(path2.charCodeAt(1))) {
       let j = 2;
       let last2 = j;
@@ -15526,17 +15594,17 @@ function winNormalize(path2) {
     device = path2.slice(0, 2);
     rootEnd = 2;
     if (len > 2 && isPathSeparator(path2.charCodeAt(2))) {
-      isAbsolute = true;
+      isAbsolute2 = true;
       rootEnd = 3;
     }
   }
-  let tail = rootEnd < len ? normalizeString(path2.slice(rootEnd), !isAbsolute, "\\", isPathSeparator) : "";
-  if (tail.length === 0 && !isAbsolute) tail = ".";
+  let tail = rootEnd < len ? normalizeString(path2.slice(rootEnd), !isAbsolute2, "\\", isPathSeparator) : "";
+  if (tail.length === 0 && !isAbsolute2) tail = ".";
   if (tail.length > 0 && isPathSeparator(path2.charCodeAt(len - 1))) tail += "\\";
   if (device === void 0) {
-    return isAbsolute ? `\\${tail}` : tail;
+    return isAbsolute2 ? `\\${tail}` : tail;
   }
-  return isAbsolute ? `${device}\\${tail}` : `${device}${tail}`;
+  return isAbsolute2 ? `${device}\\${tail}` : `${device}${tail}`;
 }
 function winIsAbsolute(path2) {
   validateString(path2, "path");
@@ -15948,15 +16016,15 @@ function posResolve(...args) {
 function posNormalize(path2) {
   validateString(path2, "path");
   if (path2.length === 0) return ".";
-  const isAbsolute = path2.charCodeAt(0) === CHAR_FORWARD_SLASH;
+  const isAbsolute2 = path2.charCodeAt(0) === CHAR_FORWARD_SLASH;
   const trailingSeparator = path2.charCodeAt(path2.length - 1) === CHAR_FORWARD_SLASH;
-  path2 = normalizeString(path2, !isAbsolute, "/", isPosixPathSeparator);
+  path2 = normalizeString(path2, !isAbsolute2, "/", isPosixPathSeparator);
   if (path2.length === 0) {
-    if (isAbsolute) return "/";
+    if (isAbsolute2) return "/";
     return trailingSeparator ? "./" : ".";
   }
   if (trailingSeparator) path2 += "/";
-  return isAbsolute ? `/${path2}` : path2;
+  return isAbsolute2 ? `/${path2}` : path2;
 }
 function posIsAbsolute(path2) {
   validateString(path2, "path");
@@ -16134,9 +16202,9 @@ function posParse(path2) {
   validateString(path2, "path");
   const ret = { root: "", dir: "", base: "", ext: "", name: "" };
   if (path2.length === 0) return ret;
-  const isAbsolute = path2.charCodeAt(0) === CHAR_FORWARD_SLASH;
+  const isAbsolute2 = path2.charCodeAt(0) === CHAR_FORWARD_SLASH;
   let start;
-  if (isAbsolute) {
+  if (isAbsolute2) {
     ret.root = "/";
     start = 1;
   } else {
@@ -16169,7 +16237,7 @@ function posParse(path2) {
     }
   }
   if (end !== -1) {
-    const start2 = startPart === 0 && isAbsolute ? 1 : startPart;
+    const start2 = startPart === 0 && isAbsolute2 ? 1 : startPart;
     if (startDot === -1 || // We saw a non-dot character immediately before the dot
     preDotState === 0 || // The (right-most) trimmed path component is exactly '..'
     preDotState === 1 && startDot === end - 1 && startDot === startPart + 1) {
@@ -16181,7 +16249,7 @@ function posParse(path2) {
     }
   }
   if (startPart > 0) ret.dir = path2.slice(0, startPart - 1);
-  else if (isAbsolute) ret.dir = "/";
+  else if (isAbsolute2) ret.dir = "/";
   return ret;
 }
 var posSep = "/";
@@ -16230,7 +16298,7 @@ var posix = {
 };
 
 // ../../node_modules/.pnpm/path-unified@0.2.0/node_modules/path-unified/src/posix.js
-var resolve = posResolve;
+var resolve2 = posResolve;
 var join8 = posJoin;
 
 // ../../node_modules/.pnpm/@isaacs+balanced-match@4.0.1/node_modules/@isaacs/balanced-match/dist/esm/index.js
@@ -19947,10 +20015,10 @@ var Minipass = class extends EventEmitter {
    * Return a void Promise that resolves once the stream ends.
    */
   async promise() {
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       this.on(DESTROYED, () => reject(new Error("stream destroyed")));
       this.on("error", (er) => reject(er));
-      this.on("end", () => resolve8());
+      this.on("end", () => resolve9());
     });
   }
   /**
@@ -19974,7 +20042,7 @@ var Minipass = class extends EventEmitter {
         return Promise.resolve({ done: false, value: res });
       if (this[EOF])
         return stop();
-      let resolve8;
+      let resolve9;
       let reject;
       const onerr = (er) => {
         this.off("data", ondata);
@@ -19988,19 +20056,19 @@ var Minipass = class extends EventEmitter {
         this.off("end", onend);
         this.off(DESTROYED, ondestroy);
         this.pause();
-        resolve8({ value: value2, done: !!this[EOF] });
+        resolve9({ value: value2, done: !!this[EOF] });
       };
       const onend = () => {
         this.off("error", onerr);
         this.off("data", ondata);
         this.off(DESTROYED, ondestroy);
         stop();
-        resolve8({ done: true, value: void 0 });
+        resolve9({ done: true, value: void 0 });
       };
       const ondestroy = () => onerr(new Error("stream destroyed"));
       return new Promise((res2, rej) => {
         reject = rej;
-        resolve8 = res2;
+        resolve9 = res2;
         this.once(DESTROYED, ondestroy);
         this.once("error", onerr);
         this.once("end", onend);
@@ -20097,13 +20165,13 @@ var Minipass = class extends EventEmitter {
 };
 
 // ../../node_modules/.pnpm/path-scurry@2.0.1/node_modules/path-scurry/dist/esm/index.js
-var realpathSync = rps.native;
+var realpathSync2 = rps.native;
 var defaultFS = {
   lstatSync,
   readdir: readdirCB,
   readdirSync,
   readlinkSync,
-  realpathSync,
+  realpathSync: realpathSync2,
   promises: {
     lstat,
     readdir,
@@ -20972,9 +21040,9 @@ var PathBase = class {
     if (this.#asyncReaddirInFlight) {
       await this.#asyncReaddirInFlight;
     } else {
-      let resolve8 = () => {
+      let resolve9 = () => {
       };
-      this.#asyncReaddirInFlight = new Promise((res) => resolve8 = res);
+      this.#asyncReaddirInFlight = new Promise((res) => resolve9 = res);
       try {
         for (const e of await this.#fs.promises.readdir(fullpath, {
           withFileTypes: true
@@ -20987,7 +21055,7 @@ var PathBase = class {
         children.provisional = 0;
       }
       this.#asyncReaddirInFlight = void 0;
-      resolve8();
+      resolve9();
     }
     return children.slice(0, children.provisional);
   }
@@ -22049,10 +22117,10 @@ var Ignore = class {
   ignored(p2) {
     const fullpath = p2.fullpath();
     const fullpaths = `${fullpath}/`;
-    const relative4 = p2.relative() || ".";
-    const relatives = `${relative4}/`;
+    const relative5 = p2.relative() || ".";
+    const relatives = `${relative5}/`;
     for (const m3 of this.relative) {
-      if (m3.match(relative4) || m3.match(relatives))
+      if (m3.match(relative5) || m3.match(relatives))
         return true;
     }
     for (const m3 of this.absolute) {
@@ -22063,9 +22131,9 @@ var Ignore = class {
   }
   childrenIgnored(p2) {
     const fullpath = p2.fullpath() + "/";
-    const relative4 = (p2.relative() || ".") + "/";
+    const relative5 = (p2.relative() || ".") + "/";
     for (const m3 of this.relativeChildren) {
-      if (m3.match(relative4))
+      if (m3.match(relative5))
         return true;
     }
     for (const m3 of this.absoluteChildren) {
@@ -22885,20 +22953,20 @@ var glob = Object.assign(glob_, {
 glob.glob = glob;
 
 // ../../node_modules/.pnpm/path-unified@0.2.0/node_modules/path-unified/src/win32.js
-var resolve2 = winResolve;
+var resolve3 = winResolve;
 
 // ../../node_modules/.pnpm/style-dictionary@5.1.1/node_modules/style-dictionary/lib/utils/isNode.js
 var isNode = typeof window === "undefined";
 
 // ../../node_modules/.pnpm/style-dictionary@5.1.1/node_modules/style-dictionary/lib/resolve.js
-var resolve3 = (path2, customVolumeUsed = false) => {
+var resolve4 = (path2, customVolumeUsed = false) => {
   if (customVolumeUsed) {
     return path2;
   }
   if (isNode && process?.platform === "win32") {
-    return resolve2(path2);
+    return resolve3(path2);
   }
-  return resolve(path2);
+  return resolve2(path2);
 };
 
 // ../../node_modules/.pnpm/is-plain-obj@4.1.0/node_modules/is-plain-obj/index.js
@@ -24242,7 +24310,7 @@ function toBase64(buffer) {
   if (isNode) {
     return buffer.toString("base64");
   } else {
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       const blob = new Blob([buffer], { type: "application/octet-stream" });
       const reader = new FileReader();
       reader.onloadend = () => {
@@ -24250,7 +24318,7 @@ function toBase64(buffer) {
           /** @type {string } */
           reader.result.split(",")[1]
         );
-        resolve8(base64String);
+        resolve9(base64String);
       };
       reader.onerror = reject;
       reader.readAsDataURL(blob);
@@ -24261,7 +24329,7 @@ async function convertToBase64(filePath, vol2 = fs2) {
   if (typeof filePath !== "string") throw new Error("Token filePath name must be a string");
   const body = (
     /** @type {Buffer} */
-    vol2.readFileSync(resolve3(filePath, vol2.__custom_fs__))
+    vol2.readFileSync(resolve4(filePath, vol2.__custom_fs__))
   );
   return toBase64(body);
 }
@@ -27863,7 +27931,7 @@ var AESDecryptionStream = class extends TransformStream {
     super({
       start() {
         Object.assign(this, {
-          ready: new Promise((resolve8) => this.resolveReady = resolve8),
+          ready: new Promise((resolve9) => this.resolveReady = resolve9),
           password: encodePassword(password2, rawPassword),
           signed,
           strength: encryptionStrength - 1,
@@ -27931,7 +27999,7 @@ var AESEncryptionStream = class extends TransformStream {
     super({
       start() {
         Object.assign(this, {
-          ready: new Promise((resolve8) => this.resolveReady = resolve8),
+          ready: new Promise((resolve9) => this.resolveReady = resolve9),
           password: encodePassword(password2, rawPassword),
           strength: encryptionStrength - 1,
           pending: new Uint8Array()
@@ -46273,31 +46341,68 @@ var CSS_LOCATIONS = {
   vite: ["src/index.css", "src/main.css", "src/styles.css", "src/app.css"],
   remix: ["app/styles/global.css", "app/globals.css", "app/root.css"],
   "react-router": ["app/app.css", "app/root.css", "app/styles.css", "app/globals.css"],
+  wc: ["src/index.css", "src/main.css", "src/styles.css", "styles/global.css"],
+  vanilla: ["src/index.css", "src/main.css", "src/styles.css", "styles/global.css"],
   unknown: ["src/styles/global.css", "src/index.css", "styles/globals.css"]
 };
 var COMPONENT_PATHS = {
   astro: {
     components: "src/components/ui",
     primitives: "src/lib/primitives",
-    composites: "src/composites"
+    composites: "src/composites",
+    rules: "src/rules"
+  },
+  next: {
+    components: "components/ui",
+    primitives: "lib/primitives",
+    composites: "composites",
+    rules: "rules"
   },
-  next: { components: "components/ui", primitives: "lib/primitives", composites: "composites" },
   vite: {
     components: "src/components/ui",
     primitives: "src/lib/primitives",
-    composites: "src/composites"
+    composites: "src/composites",
+    rules: "src/rules"
   },
   remix: {
     components: "app/components/ui",
     primitives: "app/lib/primitives",
-    composites: "app/composites"
+    composites: "app/composites",
+    rules: "app/rules"
   },
   "react-router": {
     components: "app/components/ui",
     primitives: "app/lib/primitives",
-    composites: "app/composites"
+    composites: "app/composites",
+    rules: "app/rules"
+  },
+  wc: {
+    components: "src/components/ui",
+    primitives: "src/lib/primitives",
+    composites: "src/composites",
+    rules: "src/rules"
   },
-  unknown: { components: "components/ui", primitives: "lib/primitives", composites: "composites" }
+  vanilla: {
+    components: "src/components/ui",
+    primitives: "src/lib/primitives",
+    composites: "src/composites",
+    rules: "src/rules"
+  },
+  unknown: {
+    components: "components/ui",
+    primitives: "lib/primitives",
+    composites: "composites",
+    rules: "rules"
+  }
+};
+var FRAMEWORK_PROMPT_LABELS = {
+  next: "Next.js",
+  vite: "Vite",
+  remix: "Remix",
+  "react-router": "React Router v7",
+  astro: "Astro",
+  wc: "Web Components (custom elements, shadow DOM)",
+  vanilla: "Vanilla (plain HTML/TS, no framework)"
 };
 async function findMainCssFile(cwd, framework) {
   const locations = CSS_LOCATIONS[framework] || CSS_LOCATIONS.unknown;
@@ -46314,7 +46419,7 @@ async function updateMainCss(cwd, cssPath, themePath) {
   const cssContent = await readFile8(fullCssPath, "utf-8");
   const cssDir = join10(cwd, cssPath, "..");
   const themeFullPath = join10(cwd, themePath);
-  const relativeThemePath = relative3(cssDir, themeFullPath);
+  const relativeThemePath = relative4(cssDir, themeFullPath);
   if (cssContent.includes(".rafters/output/rafters.css")) {
     log({ event: "init:css_already_imported", cssPath });
     return;
@@ -46340,6 +46445,26 @@ ${cssContent}`;
 function isInteractive() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
+async function resolveFramework(detected, flag, agentMode) {
+  if (flag) {
+    if (!isSelectableFramework(flag)) {
+      throw new Error(
+        `Unknown --framework "${flag}". Valid values: ${SELECTABLE_FRAMEWORKS.join(", ")}.`
+      );
+    }
+    return flag;
+  }
+  if (detected !== "unknown") return detected;
+  if (agentMode || !isInteractive()) return "unknown";
+  const picked = await select({
+    message: "Couldn't auto-detect your framework. Which one is this?",
+    choices: SELECTABLE_FRAMEWORKS.map((value2) => ({
+      name: FRAMEWORK_PROMPT_LABELS[value2],
+      value: value2
+    }))
+  });
+  return picked;
+}
 async function promptExportFormats(existingConfig) {
   if (!isInteractive()) {
     return existingConfig ?? DEFAULT_EXPORTS;
@@ -46440,6 +46565,7 @@ async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode2, framewor
     existingConfig.componentsPath = frameworkPaths.components;
     existingConfig.primitivesPath = frameworkPaths.primitives;
     existingConfig.compositesPath = frameworkPaths.composites;
+    existingConfig.rulesPath = frameworkPaths.rules;
   }
   const adapter = new NodePersistenceAdapter(cwd);
   const allTokens = await adapter.load();
@@ -46476,10 +46602,11 @@ async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode2, framewor
       componentsPath: frameworkPaths.components,
       primitivesPath: frameworkPaths.primitives,
       compositesPath: frameworkPaths.composites,
+      rulesPath: frameworkPaths.rules,
       cssPath: null,
       shadcn: !!shadcn,
       exports,
-      installed: { components: [], primitives: [], composites: [] }
+      installed: { components: [], primitives: [], composites: [], rules: [] }
     };
     await writeFile4(paths.config, JSON.stringify(newConfig, null, 2));
   }
@@ -46503,6 +46630,7 @@ async function resetToDefaults(cwd, paths, shadcn, isAgentMode2, framework) {
     existingConfig.componentsPath = frameworkPaths.components;
     existingConfig.primitivesPath = frameworkPaths.primitives;
     existingConfig.compositesPath = frameworkPaths.composites;
+    existingConfig.rulesPath = frameworkPaths.rules;
   }
   const adapter = new NodePersistenceAdapter(cwd);
   const existingTokens = await adapter.load();
@@ -46573,10 +46701,11 @@ async function resetToDefaults(cwd, paths, shadcn, isAgentMode2, framework) {
       componentsPath: frameworkPaths.components,
       primitivesPath: frameworkPaths.primitives,
       compositesPath: frameworkPaths.composites,
+      rulesPath: frameworkPaths.rules,
       cssPath: null,
       shadcn: !!shadcn,
       exports,
-      installed: { components: [], primitives: [], composites: [] }
+      installed: { components: [], primitives: [], composites: [], rules: [] }
     };
     await writeFile4(paths.config, JSON.stringify(newConfig, null, 2));
   }
@@ -46677,13 +46806,26 @@ async function init(options) {
   const cwd = process.cwd();
   const paths = getRaftersPaths(cwd);
   log({ event: "init:start", cwd });
-  const { framework, shadcn, tailwindVersion } = await detectProject(cwd);
+  const { framework: detectedFramework, shadcn, tailwindVersion } = await detectProject(cwd);
   log({
     event: "init:detected",
-    framework,
+    framework: detectedFramework,
     tailwindVersion,
     hasShadcn: !!shadcn
   });
+  const framework = await resolveFramework(
+    detectedFramework,
+    options.framework,
+    isAgentMode2
+  );
+  if (framework !== detectedFramework) {
+    log({
+      event: "init:framework_resolved",
+      detected: detectedFramework,
+      resolved: framework,
+      source: options.framework ? "flag" : "prompt"
+    });
+  }
   if (isTailwindV3(tailwindVersion)) {
     throw new Error("Tailwind v3 detected. Rafters requires Tailwind v4.");
   }
@@ -46780,13 +46922,15 @@ async function init(options) {
     componentsPath: frameworkPaths.components,
     primitivesPath: frameworkPaths.primitives,
     compositesPath: frameworkPaths.composites,
+    rulesPath: frameworkPaths.rules,
     cssPath: detectedCssPath,
     shadcn: !!shadcn,
     exports,
     installed: {
       components: [],
       primitives: [],
-      composites: []
+      composites: [],
+      rules: []
     }
   };
   await writeFile4(paths.config, JSON.stringify(config2, null, 2));
@@ -46822,7 +46966,7 @@ async function maybeOnboardExisting(cwd, importPendingPath) {
       event: "import:existing_detected",
       source: best.importer,
       confidence: best.confidence,
-      sourcePaths: best.sourcePaths.map((p2) => relative3(cwd, p2)).join(", "),
+      sourcePaths: best.sourcePaths.map((p2) => relative4(cwd, p2)).join(", "),
       nextStep: "Run `rafters import` to convert these tokens into pending review."
     });
     return;
@@ -46831,7 +46975,7 @@ async function maybeOnboardExisting(cwd, importPendingPath) {
     event: "import:existing_detected",
     source: best.importer,
     confidence: best.confidence,
-    sourcePaths: best.sourcePaths.map((p2) => relative3(cwd, p2)).join(", ")
+    sourcePaths: best.sourcePaths.map((p2) => relative4(cwd, p2)).join(", ")
   });
   let shouldImport;
   try {
@@ -46857,7 +47001,7 @@ async function maybeOnboardExisting(cwd, importPendingPath) {
   await writeImportPending(importPendingPath, doc);
   log({
     event: "import:complete",
-    path: relative3(cwd, importPendingPath),
+    path: relative4(cwd, importPendingPath),
     source: result.source,
     confidence: result.confidence,
     tokensCreated: result.stats.tokensCreated,
@@ -46868,7 +47012,7 @@ async function maybeOnboardExisting(cwd, importPendingPath) {
 
 // src/commands/mcp.ts
 import { existsSync as existsSync7 } from "fs";
-import { basename as basename4, join as join14, resolve as resolve6 } from "path";
+import { basename as basename4, join as join14, resolve as resolve7 } from "path";
 
 // src/mcp/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -46876,7 +47020,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
 // src/mcp/tools.ts
-import { readdir as readdir3 } from "fs/promises";
+import { readdir as readdir3, readFile as readFile9 } from "fs/promises";
 import { join as join13 } from "path";
 
 // ../composites/src/built-in-rules/email.ts
@@ -46991,13 +47135,13 @@ function search(query) {
 
 // src/utils/workspaces.ts
 import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync, statSync } from "fs";
-import { basename as basename3, dirname as dirname5, join as join12, resolve as resolve5 } from "path";
+import { basename as basename3, dirname as dirname5, join as join12, resolve as resolve6 } from "path";
 
 // src/utils/discover.ts
 import { existsSync as existsSync5 } from "fs";
-import { dirname as dirname4, join as join11, resolve as resolve4 } from "path";
+import { dirname as dirname4, join as join11, resolve as resolve5 } from "path";
 function discoverProjectRoot(startDir) {
-  let current = resolve4(startDir);
+  let current = resolve5(startDir);
   for (; ; ) {
     const configPath = join11(current, ".rafters", "config.rafters.json");
     if (existsSync5(configPath)) {
@@ -47013,8 +47157,8 @@ function discoverProjectRoot(startDir) {
 
 // src/utils/workspaces.ts
 function findMonorepoRoot(startDir, boundary) {
-  let current = resolve5(startDir);
-  const stopAt = boundary ? resolve5(boundary) : null;
+  let current = resolve6(startDir);
+  const stopAt = boundary ? resolve6(boundary) : null;
   for (; ; ) {
     const pnpmWorkspace = join12(current, "pnpm-workspace.yaml");
     if (existsSync6(pnpmWorkspace)) {
@@ -47104,7 +47248,7 @@ function discoverWorkspaces(startDir = process.cwd(), options = {}) {
   if (!layout) {
     const single = discoverProjectRoot(startDir);
     if (!single) return [];
-    if (options.boundary && !single.startsWith(resolve5(options.boundary))) return [];
+    if (options.boundary && !single.startsWith(resolve6(options.boundary))) return [];
     return [{ name: basename3(single), root: single }];
   }
   const seen = /* @__PURE__ */ new Set();
@@ -47127,7 +47271,7 @@ function discoverWorkspaces(startDir = process.cwd(), options = {}) {
 }
 function pickDefaultWorkspace(workspaces, startDir = process.cwd()) {
   if (workspaces.length === 0) return null;
-  const cwd = resolve5(startDir);
+  const cwd = resolve6(startDir);
   const containing = workspaces.find((ws) => cwd === ws.root || cwd.startsWith(`${ws.root}/`));
   if (containing) return containing;
   if (workspaces.length === 1) return workspaces[0] ?? null;
@@ -47316,8 +47460,8 @@ var RaftersToolHandler = class {
       const files = entries.filter((f) => f.endsWith(".composite.json"));
       for (const file of files) {
         try {
-          const { readFile: readFile9 } = await import("fs/promises");
-          const raw = await readFile9(join13(dir, file), "utf-8");
+          const { readFile: readFile10 } = await import("fs/promises");
+          const raw = await readFile10(join13(dir, file), "utf-8");
           const parsed = JSON.parse(raw);
           const result = CompositeFileSchema.safeParse(parsed);
           if (result.success) {
@@ -47343,11 +47487,31 @@ var RaftersToolHandler = class {
       this.builtInCompositesLoaded = true;
     }
     if (workspace && !this.compositesLoadedFor.has(workspace.root)) {
-      const paths = getRaftersPaths(workspace.root);
-      await this.loadCompositesFromDir(join13(paths.root, "composites"));
+      for (const dir of await this.compositeReadRoots(workspace.root)) {
+        await this.loadCompositesFromDir(dir);
+      }
       this.compositesLoadedFor.add(workspace.root);
     }
   }
+  /**
+   * Resolve the set of folders to scan for composite manifests in a workspace.
+   * Reads `.rafters/config.rafters.json` and applies the workspace's
+   * `compositesPath` (which may be a string or an array of entries to support
+   * shared packages like `@shingle/shared`). Falls back to `.rafters/composites`
+   * when no config or compositesPath is set.
+   */
+  async compositeReadRoots(workspaceRoot) {
+    const paths = getRaftersPaths(workspaceRoot);
+    let config2 = null;
+    try {
+      config2 = JSON.parse(await readFile9(paths.config, "utf-8"));
+    } catch {
+    }
+    if (!config2?.compositesPath) {
+      return [join13(paths.root, "composites")];
+    }
+    return resolveReadSet(config2.compositesPath, workspaceRoot);
+  }
   async handleComposite(args) {
     const { id, query, category, workspace } = args;
     const resolved = this.resolve(workspace);
@@ -47549,7 +47713,7 @@ async function mcp(options) {
   let workspaces;
   let defaultWorkspace;
   if (options.projectRoot) {
-    const explicit = resolve6(options.projectRoot);
+    const explicit = resolve7(options.projectRoot);
     const configPath = join14(explicit, ".rafters", "config.rafters.json");
     if (!existsSync7(configPath)) {
       process.stderr.write(
@@ -47572,7 +47736,7 @@ async function mcp(options) {
 
 // src/commands/studio.ts
 import { existsSync as existsSync8 } from "fs";
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 
 // ../studio/src/api/vite-plugin.ts
 import { writeFile as writeFile5 } from "fs/promises";
@@ -47719,7 +47883,7 @@ function getNamespacePatchSchema(namespace) {
 }
 var MAX_BODY_SIZE = 1024 * 1024;
 function readJsonBody(req) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     let body = "";
     let size = 0;
     req.on("data", (chunk) => {
@@ -47732,7 +47896,7 @@ function readJsonBody(req) {
     });
     req.on("end", () => {
       try {
-        resolve8(body ? JSON.parse(body) : {});
+        resolve9(body ? JSON.parse(body) : {});
       } catch {
         reject(new Error("Invalid JSON body"));
       }
@@ -48202,7 +48366,7 @@ async function studio() {
     },
     resolve: {
       alias: {
-        "@rafters-output": resolve7(cwd, ".rafters", "output")
+        "@rafters-output": resolve8(cwd, ".rafters", "output")
       }
     }
   });
@@ -48213,7 +48377,10 @@ async function studio() {
 // src/index.ts
 var program = new Command();
 program.name("rafters").description("Design system CLI - scaffold tokens and serve MCP").version("0.0.1");
-program.command("init").description("Initialize .rafters/ with default tokens and config").option("-r, --rebuild", "Regenerate output files from existing tokens").option("--reset", "Re-run generators fresh, replacing persisted tokens").option("--agent", "Output JSON for machine consumption").action(withErrorHandler(init));
+program.command("init").description("Initialize .rafters/ with default tokens and config").option("-r, --rebuild", "Regenerate output files from existing tokens").option("--reset", "Re-run generators fresh, replacing persisted tokens").option(
+  "--framework <name>",
+  "Override framework detection (next|vite|remix|react-router|astro|wc|vanilla)"
+).option("--agent", "Output JSON for machine consumption").action(withErrorHandler(init));
 program.command("import").description("Import existing design tokens (Tailwind v4, shadcn, generic CSS)").option("--force", "Overwrite existing .rafters/import-pending.json").option("--importer <id>", "Force a specific importer (tailwind-v4, shadcn, generic-css)").option("--agent", "Output JSON for machine consumption").action(withErrorHandler(importCommand));
 program.command("add").description("Add rafters components to the project").argument("[components...]", "Component names to add").option("--list", "List available components").option("--overwrite", "Overwrite existing component files").option("--update", "Re-fetch named components from registry").option("--update-all", "Re-fetch all installed components from registry").option("--registry-url <url>", "Custom registry URL").option("--agent", "Output JSON for machine consumption").action(withErrorHandler(add));
 program.command("mcp").description("Start MCP server for AI agent access (stdio)").option("--project-root <path>", "Explicit project root (skips .rafters/ discovery)").action(mcp);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.52",
+  "version": "0.0.54",
   "description": "CLI for Rafters design system - scaffold tokens and add components",
   "license": "MIT",
   "type": "module",