rafters 0.0.79 → 0.0.81

package/dist/index.js

@@ -5,7 +5,13 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a2, b2) => (typeof require !== "undefined" ? require : a2)[b2]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __export = (target, all) => {
@@ -80,9 +86,9 @@ var require_escape_html = __commonJS({
 import { Command } from "commander";
 
 // src/commands/add.ts
-import { existsSync as existsSync3 } from "fs";
-import { access, mkdir as mkdir2, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
-import { dirname, join as join7 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { access, mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
+import { dirname, join as join8 } from "path";
 
 // ../design-tokens/src/exporters/dtcg.ts
 function categoryToDTCGType(category, token) {
@@ -1253,34 +1259,59 @@ ${themeBody}`;
   }
 }
 function postProcessDocSheet(css) {
+  const csstree3 = __require("css-tree");
+  const ast = csstree3.parse(css);
   const parts = [];
-  const themeLayerRe = /@layer theme\{(.*?)\}(?=@layer|$)/s;
-  const themeMatch = themeLayerRe.exec(css);
-  if (themeMatch) {
-    let themeContent = themeMatch[1] ?? "";
-    themeContent = themeContent.replace(/:root,:host/g, ":host");
-    parts.push(`:host{container-type:inline-size}${themeContent}`);
-  }
-  const layerRe = /@layer (base|components|utilities)\{/g;
-  let match;
-  while ((match = layerRe.exec(css)) !== null) {
-    const start = match.index;
-    let depth = 0;
-    let end = start;
-    for (let i = start; i < css.length; i++) {
-      if (css[i] === "{") depth++;
-      if (css[i] === "}") {
-        depth--;
-        if (depth === 0) {
-          end = i + 1;
-          break;
+  let hasHostContainer = false;
+  const atruleNames = /* @__PURE__ */ new Set(["layer", "property", "keyframes"]);
+  csstree3.walk(ast, {
+    visit: "Atrule",
+    enter(node) {
+      if (!atruleNames.has(node.name)) return;
+      if (node.name === "layer") {
+        const prelude = node.prelude ? csstree3.generate(node.prelude) : "";
+        if (prelude === "theme" && node.block) {
+          let content = csstree3.generate(node.block);
+          content = content.replace(/^\{/, "").replace(/\}$/, "");
+          content = rewriteRootToHost(content);
+          if (!hasHostContainer) {
+            parts.push(`:host{container-type:inline-size}${content}`);
+            hasHostContainer = true;
+          } else {
+            parts.push(content);
+          }
+        } else if (/^(base|components|utilities)/.test(prelude) && node.block) {
+          parts.push(csstree3.generate(node));
+        } else if (prelude.startsWith("properties") && node.block) {
+          let block = csstree3.generate(node);
+          block = rewritePropertiesSelector(block);
+          parts.push(block);
         }
+      } else {
+        parts.push(csstree3.generate(node));
       }
     }
-    parts.push(css.slice(start, end));
-  }
+  });
+  csstree3.walk(ast, {
+    visit: "Rule",
+    enter(node, _item, list) {
+      if (list !== ast.children) return;
+      let block = csstree3.generate(node);
+      block = rewriteRootToHost(block);
+      parts.push(block);
+    }
+  });
   return parts.join("");
 }
+function rewriteRootToHost(css) {
+  return css.replace(/:root\s*,\s*:host/g, ":host").replace(/:root\[data-theme/g, ":host[data-theme").replace(/:root(?=[{\s,[])/g, ":host");
+}
+function rewritePropertiesSelector(css) {
+  return css.replace(
+    /\*\s*,\s*:?:?before\s*,\s*:?:?after\s*,\s*:?:?backdrop/g,
+    ":host,*,::before,::after"
+  );
+}
 
 // ../design-tokens/src/exporters/typescript.ts
 function tokenValueToTS(token) {
@@ -27299,194 +27330,23 @@ function generateBaseSystem(config2 = {}) {
   };
 }
 
-// ../design-tokens/src/graph.ts
-var UserOverrideSchema = external_exports.object({
-  previousValue: external_exports.unknown(),
-  reason: external_exports.string(),
-  context: external_exports.string().optional(),
-  // Provenance. Optional by design: absent means unknown, which is what every
-  // override written before this field existed actually is.
-  kind: OverrideKindSchema.optional()
-});
-var BindingSchema2 = external_exports.object({
-  plugin: external_exports.string(),
-  input: external_exports.unknown()
-});
-var NodeSchema = external_exports.object({
-  name: external_exports.string(),
-  value: external_exports.unknown(),
-  binding: BindingSchema2.optional(),
-  userOverride: UserOverrideSchema.optional()
-});
-var CircularDependencyError = class extends Error {
-  constructor(cycle) {
-    super(`Circular dependency: ${cycle.join(" -> ")}`);
-    this.cycle = cycle;
-    this.name = "CircularDependencyError";
-  }
-};
-var UnknownPluginError = class extends Error {
-  constructor(pluginName) {
-    super(`Unknown plugin: ${pluginName}`);
-    this.pluginName = pluginName;
-    this.name = "UnknownPluginError";
-  }
-};
-var TokenGraph = class {
-  nodes = /* @__PURE__ */ new Map();
-  plugins = /* @__PURE__ */ new Map();
-  snapshot = null;
-  constructor(plugins = []) {
-    for (const plugin of plugins) this.plugins.set(plugin.name, plugin);
-  }
-  registerPlugin(plugin) {
-    this.plugins.set(plugin.name, plugin);
-  }
-  set(name, value, options) {
-    this.takeSnapshot();
-    const existing = this.nodes.get(name);
-    const next = {
-      name,
-      value,
-      userOverride: {
-        previousValue: existing?.value,
-        reason: options.reason,
-        ...options.context ? { context: options.context } : {},
-        ...options.kind ? { kind: options.kind } : {}
-      },
-      ...existing?.binding ? { binding: existing.binding } : {}
-    };
-    this.nodes.set(name, next);
-    this.cascadeFrom(name);
-  }
-  // Hydrate a node from persisted state. No cascade fires; the caller
-  // (registry constructor) is responsible for ordering: leaves first, then
-  // bindings. userOverride / binding are preserved verbatim from the persisted
-  // token so that the anchor + re-derivation hook both survive reload.
-  seed(name, value, extras) {
-    this.nodes.set(name, {
-      name,
-      value,
-      ...extras?.userOverride ? { userOverride: extras.userOverride } : {},
-      ...extras?.binding ? { binding: extras.binding } : {}
-    });
-  }
-  bind(name, pluginName, input) {
-    const plugin = this.requirePlugin(pluginName);
-    plugin.inputSchema.parse(input);
-    const directDeps = plugin.dependsOn(input);
-    this.assertNoCycle(name, directDeps);
-    this.takeSnapshot();
-    const value = plugin.transform(input, (n2) => this.get(n2));
-    plugin.outputSchema.parse(value);
-    this.nodes.set(name, { name, value, binding: { plugin: pluginName, input } });
-    this.cascadeFrom(name);
-  }
-  get(name) {
-    return this.nodes.get(name)?.value;
-  }
-  node(name) {
-    return this.nodes.get(name);
-  }
-  undo() {
-    if (!this.snapshot) return;
-    this.nodes = this.snapshot;
-    this.snapshot = null;
-  }
-  has(name) {
-    return this.nodes.has(name);
-  }
-  list(filter) {
-    const all = Array.from(this.nodes.values());
-    if (!filter?.namespace) return all;
-    const prefix = filter.namespace;
-    return all.filter(
-      (n2) => n2.name === prefix || n2.name.startsWith(`${prefix}-`) || n2.name.startsWith(`${prefix}.`)
-    );
-  }
-  size() {
-    return this.nodes.size;
-  }
-  requirePlugin(pluginName) {
-    const plugin = this.plugins.get(pluginName);
-    if (!plugin) throw new UnknownPluginError(pluginName);
-    return plugin;
-  }
-  takeSnapshot() {
-    this.snapshot = /* @__PURE__ */ new Map();
-    for (const [k, v] of this.nodes) this.snapshot.set(k, structuredClone(v));
-  }
-  cascadeFrom(changed) {
-    const dependents = this.collectDependents(changed);
-    if (dependents.size === 0) return;
-    const ordered = this.topoSort(dependents);
-    for (const name of ordered) {
-      const node = this.nodes.get(name);
-      if (!node || node.userOverride || !node.binding) continue;
-      const plugin = this.requirePlugin(node.binding.plugin);
-      const value = plugin.transform(node.binding.input, (n2) => this.get(n2));
-      plugin.outputSchema.parse(value);
-      this.nodes.set(name, { ...node, value });
-    }
-  }
-  collectDependents(changed) {
-    const out = /* @__PURE__ */ new Set();
-    const queue = [changed];
-    while (queue.length > 0) {
-      const current = queue.shift();
-      for (const [name, node] of this.nodes) {
-        if (out.has(name) || !node.binding) continue;
-        const plugin = this.plugins.get(node.binding.plugin);
-        if (!plugin) continue;
-        if (plugin.dependsOn(node.binding.input).includes(current)) {
-          out.add(name);
-          queue.push(name);
-        }
-      }
-    }
-    return out;
-  }
-  topoSort(names) {
-    const sorted = [];
-    const visited = /* @__PURE__ */ new Set();
-    const visiting = /* @__PURE__ */ new Set();
-    const visit = (name, path) => {
-      if (visited.has(name)) return;
-      if (visiting.has(name)) throw new CircularDependencyError([...path, name]);
-      visiting.add(name);
-      const node = this.nodes.get(name);
-      if (node?.binding) {
-        const plugin = this.plugins.get(node.binding.plugin);
-        if (plugin) {
-          for (const dep of plugin.dependsOn(node.binding.input)) {
-            if (names.has(dep)) visit(dep, [...path, name]);
-          }
-        }
-      }
-      visiting.delete(name);
-      visited.add(name);
-      sorted.push(name);
-    };
-    for (const name of names) visit(name, []);
-    return sorted;
-  }
-  assertNoCycle(name, directDeps) {
-    const visited = /* @__PURE__ */ new Set();
-    const dfs = (current, path) => {
-      if (current === name) throw new CircularDependencyError([...path, current]);
-      if (visited.has(current)) return;
-      visited.add(current);
-      const node = this.nodes.get(current);
-      if (!node?.binding) return;
-      const plugin = this.plugins.get(node.binding.plugin);
-      if (!plugin) return;
-      for (const dep of plugin.dependsOn(node.binding.input)) {
-        dfs(dep, [...path, current]);
-      }
-    };
-    for (const dep of directDeps) dfs(dep, [name]);
+// ../design-tokens/src/importers/adapter.ts
+var adapters = /* @__PURE__ */ new Map();
+function register2(adapter) {
+  if (adapters.has(adapter.name)) {
+    throw new Error(`DesignSystemAdapter "${adapter.name}" is already registered.`);
   }
-};
+  adapters.set(adapter.name, adapter);
+}
+function getAdapter(name) {
+  const adapter = adapters.get(name);
+  if (adapter !== void 0) return adapter;
+  const known = getAvailableAdapters();
+  throw new Error(`Unknown design system adapter "${name}". Valid values: ${known.join(", ")}.`);
+}
+function getAvailableAdapters() {
+  return [...adapters.keys()].sort();
+}
 
 // ../design-tokens/src/importers/shadcn.ts
 import * as csstree from "css-tree";
@@ -27654,46 +27514,6 @@ function classifyDeclarations(declarations) {
   return { byNamespace: buckets, unclassified };
 }
 
-// ../design-tokens/src/importers/color.ts
-function importColorFamily(name, seedPosition, seed) {
-  const seedIndex = POSITION_TO_INDEX[seedPosition];
-  if (seedIndex === void 0) {
-    throw new Error(`importColorFamily: unknown scale position "${seedPosition}"`);
-  }
-  const built = buildColorValue(seed, { token: name });
-  if (built.scale.length !== SCALE_POSITIONS.length) {
-    throw new Error(
-      `importColorFamily: buildColorValue returned ${built.scale.length} positions, expected ${SCALE_POSITIONS.length}`
-    );
-  }
-  const scale2 = [...built.scale];
-  scale2[seedIndex] = seed;
-  const value = { ...built, name, scale: scale2 };
-  const tokens = [
-    {
-      name,
-      namespace: "color",
-      category: "color",
-      value,
-      userOverride: null,
-      containerQueryAware: true
-    }
-  ];
-  for (const [i, pos] of SCALE_POSITIONS.entries()) {
-    const oklch2 = value.scale[i];
-    if (!oklch2) continue;
-    tokens.push({
-      name: `${name}-${pos}`,
-      namespace: "color",
-      category: "color",
-      value: oklchToCSS(oklch2),
-      userOverride: null,
-      containerQueryAware: true
-    });
-  }
-  return tokens;
-}
-
 // ../design-tokens/src/importers/colors.ts
 function colorsFromClassification(classification) {
   const result = [];
@@ -27728,9 +27548,14 @@ var GENERIC_KEYWORDS = /* @__PURE__ */ new Set([
   "revert",
   "revert-layer"
 ]);
+var SOURCE_PRIORITY = {
+  declaration: 0,
+  google: 1,
+  "font-face": 2
+};
 function detectFonts(css) {
   const found = /* @__PURE__ */ new Map();
-  const accept = (name, stack, sourceDeclName) => {
+  const accept = (name, stack, source, sourceDeclName) => {
     if (name === null) return;
     const canonical = normalizeFamilyName(name);
     if (canonical === "" || GENERIC_KEYWORDS.has(canonical.toLowerCase())) return;
@@ -27740,30 +27565,33 @@ function detectFonts(css) {
       found.set(key, {
         name: canonical,
         stack,
+        source,
         ...sourceDeclName && { sourceDeclName }
       });
       return;
     }
+    const mergedSource = SOURCE_PRIORITY[source] > SOURCE_PRIORITY[existing.source] ? source : existing.source;
     const mergedStack = stack.length > existing.stack.length ? stack : existing.stack;
     const mergedDeclName = existing.sourceDeclName ?? sourceDeclName;
     found.set(key, {
       name: existing.name,
       stack: mergedStack,
+      source: mergedSource,
       ...mergedDeclName && { sourceDeclName: mergedDeclName }
     });
   };
   for (const family of extractGoogleFontFamilies(css)) {
-    accept(family, quoteIfNeeded(family));
+    accept(family, quoteIfNeeded(family), "google");
   }
   for (const family of extractFontFaceFamilies(css)) {
-    accept(family, quoteIfNeeded(family));
+    accept(family, quoteIfNeeded(family), "font-face");
   }
   const rootDecls = extractShadcnRoot(css);
   const themeDecls = extractThemeBlocks2(css);
   for (const decl of [...rootDecls, ...themeDecls]) {
     if (!decl.name.startsWith("font-")) continue;
     const first = firstFamilyFromStack(decl.value);
-    accept(first, decl.value.trim(), decl.name);
+    accept(first, decl.value.trim(), "declaration", decl.name);
   }
   return Array.from(found.values());
 }
@@ -27838,8 +27666,271 @@ function quoteIfNeeded(name) {
   return `"${name}"`;
 }
 
-// ../design-tokens/src/importers/sense.ts
-function senseShadcnCss(css) {
+// ../design-tokens/src/importers/shadcn-adapter.ts
+var sharedDetection = {
+  detectFonts(css) {
+    return [...detectFonts(css)];
+  },
+  detectColors(css) {
+    const declarations = extractShadcnRoot(css);
+    const classification = classifyDeclarations(declarations);
+    return [...colorsFromClassification(classification)];
+  },
+  detectSpacing(css) {
+    const value = detectSpacingBase(css);
+    return value !== null ? { base: value } : {};
+  },
+  detectRadius(css) {
+    const value = detectRadiusBase(css);
+    return value !== null ? { base: value } : {};
+  },
+  detectFocusRing(css) {
+    const value = detectFocusRingWidth(css);
+    return value !== null ? { width: value } : {};
+  },
+  detectFontSize(css) {
+    const value = detectFontSizeBase(css);
+    return value !== null ? { base: value } : {};
+  }
+};
+var shadcnAdapter = { name: "shadcn", ...sharedDetection };
+register2(shadcnAdapter);
+
+// ../design-tokens/src/importers/tailwind-adapter.ts
+var tailwindAdapter = { name: "tailwind", ...sharedDetection };
+register2(tailwindAdapter);
+
+// ../design-tokens/src/graph.ts
+var UserOverrideSchema = external_exports.object({
+  previousValue: external_exports.unknown(),
+  reason: external_exports.string(),
+  context: external_exports.string().optional(),
+  // Provenance. Optional by design: absent means unknown, which is what every
+  // override written before this field existed actually is.
+  kind: OverrideKindSchema.optional()
+});
+var BindingSchema2 = external_exports.object({
+  plugin: external_exports.string(),
+  input: external_exports.unknown()
+});
+var NodeSchema = external_exports.object({
+  name: external_exports.string(),
+  value: external_exports.unknown(),
+  binding: BindingSchema2.optional(),
+  userOverride: UserOverrideSchema.optional()
+});
+var CircularDependencyError = class extends Error {
+  constructor(cycle) {
+    super(`Circular dependency: ${cycle.join(" -> ")}`);
+    this.cycle = cycle;
+    this.name = "CircularDependencyError";
+  }
+};
+var UnknownPluginError = class extends Error {
+  constructor(pluginName) {
+    super(`Unknown plugin: ${pluginName}`);
+    this.pluginName = pluginName;
+    this.name = "UnknownPluginError";
+  }
+};
+var TokenGraph = class {
+  nodes = /* @__PURE__ */ new Map();
+  plugins = /* @__PURE__ */ new Map();
+  snapshot = null;
+  constructor(plugins = []) {
+    for (const plugin of plugins) this.plugins.set(plugin.name, plugin);
+  }
+  registerPlugin(plugin) {
+    this.plugins.set(plugin.name, plugin);
+  }
+  set(name, value, options) {
+    this.takeSnapshot();
+    const existing = this.nodes.get(name);
+    const next = {
+      name,
+      value,
+      userOverride: {
+        previousValue: existing?.value,
+        reason: options.reason,
+        ...options.context ? { context: options.context } : {},
+        ...options.kind ? { kind: options.kind } : {}
+      },
+      ...existing?.binding ? { binding: existing.binding } : {}
+    };
+    this.nodes.set(name, next);
+    this.cascadeFrom(name);
+  }
+  // Hydrate a node from persisted state. No cascade fires; the caller
+  // (registry constructor) is responsible for ordering: leaves first, then
+  // bindings. userOverride / binding are preserved verbatim from the persisted
+  // token so that the anchor + re-derivation hook both survive reload.
+  seed(name, value, extras) {
+    this.nodes.set(name, {
+      name,
+      value,
+      ...extras?.userOverride ? { userOverride: extras.userOverride } : {},
+      ...extras?.binding ? { binding: extras.binding } : {}
+    });
+  }
+  bind(name, pluginName, input) {
+    const plugin = this.requirePlugin(pluginName);
+    plugin.inputSchema.parse(input);
+    const directDeps = plugin.dependsOn(input);
+    this.assertNoCycle(name, directDeps);
+    this.takeSnapshot();
+    const value = plugin.transform(input, (n2) => this.get(n2));
+    plugin.outputSchema.parse(value);
+    this.nodes.set(name, { name, value, binding: { plugin: pluginName, input } });
+    this.cascadeFrom(name);
+  }
+  get(name) {
+    return this.nodes.get(name)?.value;
+  }
+  node(name) {
+    return this.nodes.get(name);
+  }
+  undo() {
+    if (!this.snapshot) return;
+    this.nodes = this.snapshot;
+    this.snapshot = null;
+  }
+  has(name) {
+    return this.nodes.has(name);
+  }
+  list(filter) {
+    const all = Array.from(this.nodes.values());
+    if (!filter?.namespace) return all;
+    const prefix = filter.namespace;
+    return all.filter(
+      (n2) => n2.name === prefix || n2.name.startsWith(`${prefix}-`) || n2.name.startsWith(`${prefix}.`)
+    );
+  }
+  size() {
+    return this.nodes.size;
+  }
+  requirePlugin(pluginName) {
+    const plugin = this.plugins.get(pluginName);
+    if (!plugin) throw new UnknownPluginError(pluginName);
+    return plugin;
+  }
+  takeSnapshot() {
+    this.snapshot = /* @__PURE__ */ new Map();
+    for (const [k, v] of this.nodes) this.snapshot.set(k, structuredClone(v));
+  }
+  cascadeFrom(changed) {
+    const dependents = this.collectDependents(changed);
+    if (dependents.size === 0) return;
+    const ordered = this.topoSort(dependents);
+    for (const name of ordered) {
+      const node = this.nodes.get(name);
+      if (!node || node.userOverride || !node.binding) continue;
+      const plugin = this.requirePlugin(node.binding.plugin);
+      const value = plugin.transform(node.binding.input, (n2) => this.get(n2));
+      plugin.outputSchema.parse(value);
+      this.nodes.set(name, { ...node, value });
+    }
+  }
+  collectDependents(changed) {
+    const out = /* @__PURE__ */ new Set();
+    const queue = [changed];
+    while (queue.length > 0) {
+      const current = queue.shift();
+      for (const [name, node] of this.nodes) {
+        if (out.has(name) || !node.binding) continue;
+        const plugin = this.plugins.get(node.binding.plugin);
+        if (!plugin) continue;
+        if (plugin.dependsOn(node.binding.input).includes(current)) {
+          out.add(name);
+          queue.push(name);
+        }
+      }
+    }
+    return out;
+  }
+  topoSort(names) {
+    const sorted = [];
+    const visited = /* @__PURE__ */ new Set();
+    const visiting = /* @__PURE__ */ new Set();
+    const visit = (name, path) => {
+      if (visited.has(name)) return;
+      if (visiting.has(name)) throw new CircularDependencyError([...path, name]);
+      visiting.add(name);
+      const node = this.nodes.get(name);
+      if (node?.binding) {
+        const plugin = this.plugins.get(node.binding.plugin);
+        if (plugin) {
+          for (const dep of plugin.dependsOn(node.binding.input)) {
+            if (names.has(dep)) visit(dep, [...path, name]);
+          }
+        }
+      }
+      visiting.delete(name);
+      visited.add(name);
+      sorted.push(name);
+    };
+    for (const name of names) visit(name, []);
+    return sorted;
+  }
+  assertNoCycle(name, directDeps) {
+    const visited = /* @__PURE__ */ new Set();
+    const dfs = (current, path) => {
+      if (current === name) throw new CircularDependencyError([...path, current]);
+      if (visited.has(current)) return;
+      visited.add(current);
+      const node = this.nodes.get(current);
+      if (!node?.binding) return;
+      const plugin = this.plugins.get(node.binding.plugin);
+      if (!plugin) return;
+      for (const dep of plugin.dependsOn(node.binding.input)) {
+        dfs(dep, [...path, current]);
+      }
+    };
+    for (const dep of directDeps) dfs(dep, [name]);
+  }
+};
+
+// ../design-tokens/src/importers/color.ts
+function importColorFamily(name, seedPosition, seed) {
+  const seedIndex = POSITION_TO_INDEX[seedPosition];
+  if (seedIndex === void 0) {
+    throw new Error(`importColorFamily: unknown scale position "${seedPosition}"`);
+  }
+  const built = buildColorValue(seed, { token: name });
+  if (built.scale.length !== SCALE_POSITIONS.length) {
+    throw new Error(
+      `importColorFamily: buildColorValue returned ${built.scale.length} positions, expected ${SCALE_POSITIONS.length}`
+    );
+  }
+  const scale2 = [...built.scale];
+  scale2[seedIndex] = seed;
+  const value = { ...built, name, scale: scale2 };
+  const tokens = [
+    {
+      name,
+      namespace: "color",
+      category: "color",
+      value,
+      userOverride: null,
+      containerQueryAware: true
+    }
+  ];
+  for (const [i, pos] of SCALE_POSITIONS.entries()) {
+    const oklch2 = value.scale[i];
+    if (!oklch2) continue;
+    tokens.push({
+      name: `${name}-${pos}`,
+      namespace: "color",
+      category: "color",
+      value: oklchToCSS(oklch2),
+      userOverride: null,
+      containerQueryAware: true
+    });
+  }
+  return tokens;
+}
+
+// ../design-tokens/src/importers/sense.ts
+function senseShadcnCss(css) {
   const declarations = extractShadcnRoot(css);
   const classification = classifyDeclarations(declarations);
   const byNamespace = Object.fromEntries(
@@ -29330,912 +29421,566 @@ function isPathField(value) {
   return typeof value === "string" || Array.isArray(value);
 }
 
-// src/commands/add.ts
+// src/commands/init.ts
+import { existsSync as existsSync3 } from "fs";
+import { copyFile, mkdir as mkdir2, readFile as readFile3, rm, writeFile as writeFile2 } from "fs/promises";
+import { createRequire } from "module";
+import { join as join7, relative as relative2 } from "path";
+import { checkbox, confirm, select } from "@inquirer/prompts";
 var REGISTRY_PLUGINS = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
-async function regenerateAfterInstall(cwd, config2) {
-  const paths = getRaftersPaths(cwd);
-  let registry2;
-  try {
-    registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS);
-  } catch {
-    return;
-  }
-  if (registry2.size() === 0) return;
-  try {
-    await regenerateOutputs(registry2, {
-      outputDir: paths.output,
-      exports: config2.exports,
-      contentSources: resolveContentSources(cwd, config2),
-      darkMode: config2.darkMode ?? "class",
-      includeImport: !config2.shadcn
-    });
-  } catch (err) {
-    log({
-      event: "add:regen-failed",
-      message: `Output regeneration failed: ${err instanceof Error ? err.message : String(err)}`
-    });
-  }
+async function backupCss(cssPath) {
+  const backupPath = cssPath.replace(/\.css$/, ".backup.css");
+  await copyFile(cssPath, backupPath);
+  return backupPath;
 }
-async function isInitialized(cwd) {
-  const paths = getRaftersPaths(cwd);
-  try {
-    await access(paths.root);
-    return true;
-  } catch {
-    return false;
+function cleanSourceCssBlocks(content) {
+  function parseBlocks(src) {
+    const blocks = [];
+    let depth = 0;
+    const headerStack = [];
+    let segmentStart = 0;
+    for (let i = 0; i < src.length; i++) {
+      const ch = src.charAt(i);
+      if (ch === "{") {
+        headerStack.push(segmentStart);
+        depth++;
+        if (depth >= 1) {
+          blocks.push({
+            headerStart: segmentStart,
+            bodyStart: i + 1,
+            end: -1,
+            header: src.slice(segmentStart, i).trim()
+          });
+        }
+        segmentStart = i + 1;
+      } else if (ch === "}") {
+        depth--;
+        const open = blocks.slice().reverse().find((b2) => b2.end === -1);
+        if (open) open.end = i + 1;
+        headerStack.pop();
+        segmentStart = i + 1;
+      } else if (ch === ";") {
+        segmentStart = i + 1;
+      }
+    }
+    return blocks.filter((b2) => b2.end !== -1);
   }
-}
-async function loadConfig(cwd) {
-  const paths = getRaftersPaths(cwd);
-  try {
-    const content = await readFile3(paths.config, "utf-8");
-    return JSON.parse(content);
-  } catch (err) {
-    if (existsSync3(paths.config)) {
-      const message = err instanceof Error ? err.message : String(err);
-      log({ event: "add:warning", message: `Failed to load config: ${message}` });
+  function isContentEmpty(body) {
+    return body.replace(/\/\*[\s\S]*?\*\//g, "").trim().length === 0;
+  }
+  let out = content;
+  for (let pass = 0; pass < 10; pass++) {
+    const blocks = parseBlocks(out);
+    let edited = false;
+    for (const block of blocks.sort((a2, b2) => b2.headerStart - a2.headerStart)) {
+      const header = block.header;
+      if (/^@theme\s+inline$/.test(header)) {
+        out = out.slice(0, block.headerStart) + out.slice(block.end);
+        edited = true;
+        break;
+      }
+      if (header === ":root" || /(^|,)\s*:root\s*$/.test(header)) {
+        const body = out.slice(block.bodyStart, block.end - 1);
+        const cleanedBody = body.replace(/--[\w-]+\s*:[^;{}]*;?/g, "");
+        if (isContentEmpty(cleanedBody)) {
+          out = out.slice(0, block.headerStart) + out.slice(block.end);
+          edited = true;
+          break;
+        }
+        if (cleanedBody !== body) {
+          out = out.slice(0, block.bodyStart) + cleanedBody + out.slice(block.end - 1);
+          edited = true;
+          break;
+        }
+        continue;
+      }
+      if (header.startsWith("@media") || header.startsWith("@supports")) {
+        const body = out.slice(block.bodyStart, block.end - 1);
+        if (isContentEmpty(body)) {
+          out = out.slice(0, block.headerStart) + out.slice(block.end);
+          edited = true;
+          break;
+        }
+      }
     }
-    return null;
+    if (!edited) break;
   }
+  return out.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
 }
-function resolveRegistryUrl(options, config2) {
-  return options.registryUrl ?? config2?.registryUrl;
+async function stripImportedDeclarations(cwd, cssPath, importedNames) {
+  if (importedNames.length === 0) return;
+  const fullPath = join7(cwd, cssPath);
+  const content = await readFile3(fullPath, "utf-8");
+  const pattern = new RegExp(importedNames.map((n2) => `^\\s*--${n2}[^;]*;\\s*$`).join("|"), "gm");
+  const cleaned = cleanSourceCssBlocks(content.replace(pattern, ""));
+  const collapsed = cleaned.replace(/\n{3,}/g, "\n\n");
+  await writeFile2(fullPath, collapsed);
 }
-async function saveConfig(cwd, config2) {
-  const paths = getRaftersPaths(cwd);
-  await writeFile2(paths.config, JSON.stringify(config2, null, 2));
+function migrateConfig(raw) {
+  if ("shadcn" in raw && !("source" in raw)) {
+    if (raw.shadcn === true) {
+      raw.source = "shadcn";
+    }
+    delete raw.shadcn;
+  }
+  return raw;
 }
-function getInstalledNames(config2) {
-  if (!config2?.installed) return [];
-  const names = /* @__PURE__ */ new Set([
-    ...config2.installed.components,
-    ...config2.installed.primitives,
-    ...config2.installed.composites ?? [],
-    ...config2.installed.rules ?? [],
-    ...config2.installed.substrate ?? []
-  ]);
-  return [...names].sort();
+async function updateMainCss(cwd, cssPath, themePath) {
+  const fullCssPath = join7(cwd, cssPath);
+  const cssContent = await readFile3(fullCssPath, "utf-8");
+  const cssDir = join7(cwd, cssPath, "..");
+  const themeFullPath = join7(cwd, themePath);
+  const relativeThemePath = relative2(cssDir, themeFullPath);
+  if (cssContent.includes(".rafters/output/rafters.css")) {
+    log({ event: "init:css_already_imported", cssPath });
+    return;
+  }
+  await backupCss(fullCssPath);
+  let newContent;
+  if (cssContent.includes('@import "tailwindcss"')) {
+    newContent = cssContent.replace('@import "tailwindcss";', `@import "${relativeThemePath}";`);
+  } else if (cssContent.includes("@import 'tailwindcss'")) {
+    newContent = cssContent.replace("@import 'tailwindcss';", `@import "${relativeThemePath}";`);
+  } else {
+    newContent = `@import "${relativeThemePath}";
+
+${cssContent}`;
+  }
+  await writeFile2(fullCssPath, newContent);
+  log({
+    event: "init:css_updated",
+    cssPath,
+    themePath: relativeThemePath
+  });
 }
-async function discoverUntrackedNames(cwd, config2, client, tracked) {
-  let index = null;
-  try {
-    index = await client.fetchIndex();
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    log({
-      event: "add:warning",
-      message: `Could not read the registry index to reconcile on-disk components (${message}). Updating tracked components only.`
+function isInteractive() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+function resolveSourceCssPath(cwd, framework, detectedFramework, projectCssPath, shadcnCssPath, emit) {
+  if (shadcnCssPath) {
+    if (existsSync3(join7(cwd, shadcnCssPath))) return shadcnCssPath;
+    const fallback = framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
+    emit({
+      event: "init:shadcn_css_missing",
+      configuredPath: shadcnCssPath,
+      fallbackPath: fallback,
+      message: "components.json points at a CSS file that does not exist. Falling back to the framework canonical location."
     });
+    return fallback;
   }
-  const { untracked } = buildUpdateCandidates(tracked, index, readInstallRoots(cwd, config2));
-  return untracked;
+  return framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
 }
-function getComponentTarget(config2) {
-  return resolveComponentTarget(config2);
+function slugifyFontName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
-var SHARED_EXTENSIONS = /* @__PURE__ */ new Set([".behavior.ts", ".classes.ts"]);
-function isSharedFile(path) {
-  for (const ext of SHARED_EXTENSIONS) {
-    if (path.endsWith(ext)) return true;
-  }
-  return false;
+function isFontStackValue(value) {
+  if (typeof value !== "string") return false;
+  if (value.startsWith("var(")) return false;
+  if (/[,'"]/.test(value)) return true;
+  return /\b(sans-serif|serif|monospace|cursive|fantasy|system-ui|ui-(?:sans-serif|serif|monospace|rounded))\b/.test(
+    value
+  );
 }
-var REACT_FALLBACK_TARGETS = /* @__PURE__ */ new Set(["astro", "vue", "svelte"]);
-function selectFilesForFramework(files, target) {
-  const preferredExt = targetToExtension(target);
-  const shared = files.filter((f) => isSharedFile(f.path));
-  const matched = files.filter((f) => f.path.endsWith(preferredExt));
-  if (matched.length > 0) {
-    return { files: [...matched, ...shared], fallback: false };
-  }
-  if (REACT_FALLBACK_TARGETS.has(target)) {
-    const fallbackFiles = files.filter((f) => f.path.endsWith(".tsx"));
-    if (fallbackFiles.length > 0) {
-      return { files: [...fallbackFiles, ...shared], fallback: true };
+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 (target !== "react" && !REACT_FALLBACK_TARGETS.has(target)) {
-    return { files: shared, fallback: false };
-  }
-  return { files, fallback: false };
-}
-var TARGET_GATED_COMPOSITE_FILES = [
-  { suffix: "Composite.astro", target: "astro" }
-];
-function selectCompositeFiles(files, target) {
-  return files.filter((file2) => {
-    const gate = TARGET_GATED_COMPOSITE_FILES.find((g2) => file2.path.endsWith(g2.suffix));
-    return gate ? gate.target === target : true;
+  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((value) => ({
+      name: FRAMEWORK_SPECS[value].label ?? value,
+      value
+    }))
   });
+  return picked;
 }
-var FOLDER_NAMES = /* @__PURE__ */ new Set(["composites"]);
-function isAlreadyInstalled(config2, item) {
-  if (!config2?.installed) return false;
-  const { components, primitives, composites: composites2, rules, substrate } = config2.installed;
-  const bucketByType = {
-    ui: components,
-    primitive: primitives,
-    composite: composites2 ?? [],
-    rule: rules ?? [],
-    substrate: substrate ?? []
-  };
-  return bucketByType[item.type].includes(item.name);
-}
-function isInstalledOnDisk(config2, item, cwd) {
-  if (!isAlreadyInstalled(config2, item)) return false;
-  const filesToCheck = item.type === "ui" ? selectFilesForFramework(item.files, getComponentTarget(config2)).files : item.files;
-  for (const file2 of filesToCheck) {
-    if (fileExists(cwd, transformPath(file2.path, config2, cwd))) return true;
-  }
-  return false;
-}
-function trackInstalled(config2, items) {
-  if (!config2.installed) {
-    config2.installed = { components: [], primitives: [], composites: [], rules: [] };
+async function promptExportFormats(existingConfig) {
+  if (!isInteractive()) {
+    return existingConfig ?? DEFAULT_EXPORTS;
   }
-  const installed = config2.installed;
-  if (!installed.composites) installed.composites = [];
-  if (!installed.rules) installed.rules = [];
-  if (!installed.substrate) installed.substrate = [];
-  const bucketByType = {
-    ui: installed.components,
-    primitive: installed.primitives,
-    composite: installed.composites,
-    rule: installed.rules,
-    substrate: installed.substrate
-  };
-  for (const item of items) {
-    const bucket = bucketByType[item.type];
-    if (!bucket.includes(item.name)) bucket.push(item.name);
-  }
-  installed.components.sort();
-  installed.primitives.sort();
-  installed.composites.sort();
-  installed.rules.sort();
-  installed.substrate.sort();
-}
-function rootFor(field, cwd, fallback) {
-  return field === void 0 ? fallback : resolveRoot(field, cwd, fallback);
-}
-function transformPath(registryPath, config2, cwd = process.cwd()) {
-  if (!config2) return registryPath;
-  const replacements = [
-    ["components/ui/", config2.componentsPath, "components/ui"],
-    ["lib/primitives/", config2.primitivesPath, "lib/primitives"],
-    ["composites/", config2.compositesPath, "composites"],
-    ["rules/", config2.rulesPath, "lib/rules"]
+  const choices = EXPORT_CHOICES.map((choice) => ({
+    name: choice.name,
+    value: choice.value,
+    checked: existingConfig ? existingConfig[choice.value] : choice.checked
+  }));
+  const allChoices = [
+    ...choices,
+    ...FUTURE_EXPORTS.map((choice) => ({
+      name: `${choice.name} (${choice.disabled})`,
+      value: choice.value,
+      checked: false,
+      disabled: true
+    }))
   ];
-  for (const [prefix, field, fallback] of replacements) {
-    if (registryPath.startsWith(prefix)) {
-      return registryPath.replace(prefix, `${rootFor(field, cwd, fallback)}/`);
+  const selections = await checkbox({
+    message: "What would you like to export?",
+    choices: allChoices,
+    required: true
+  });
+  return selectionsToConfig(selections);
+}
+function isTailwindCliInstalled() {
+  const require2 = createRequire(import.meta.url);
+  try {
+    require2.resolve("@tailwindcss/cli/package.json");
+    return true;
+  } catch (err) {
+    if (err instanceof Error && "code" in err && err.code === "MODULE_NOT_FOUND") {
+      return false;
     }
+    throw err;
   }
-  return registryPath;
-}
-function substrateProjectPath(registryPath, config2, cwd = process.cwd()) {
-  const componentsResolved = rootFor(config2?.componentsPath, cwd, "components/ui");
-  const sourceRoot = componentsResolved.replace(/\/?components\/ui$/, "");
-  return sourceRoot ? join7(sourceRoot, registryPath) : registryPath;
-}
-function fileExists(cwd, relativePath) {
-  return existsSync3(join7(cwd, relativePath));
 }
-function transformFileContent(content, config2, fileType = "component", cwd = process.cwd(), opts = {}) {
-  const { substrateKinds = [], installPath } = opts;
-  let transformed = content;
-  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);
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/\.\.\/primitives\/([^'"]+)['"]/g,
-    `from '@/${aliasPrimitives}/$1'`
-  );
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/primitives\/([^'"]+)['"]/g,
-    `from '@/${aliasPrimitives}/$1'`
-  );
-  const substrateOwnDir = fileType === "substrate" && installPath ? stripSourceRoot(dirname(installPath)) : null;
-  const aliasSibling = fileType === "primitive" ? aliasPrimitives : substrateOwnDir ?? aliasComponents;
-  transformed = transformed.replace(/from\s+['"]\.\/([^'"]+)['"]/g, `from '@/${aliasSibling}/$1'`);
-  if (substrateKinds.length > 0) {
-    const kindAlternation = substrateKinds.join("|");
-    transformed = transformed.replace(
-      new RegExp(`from\\s+['"](?:\\.\\./){1,2}(${kindAlternation})/([^'"]+)['"]`, "g"),
-      "from '@/$1/$2'"
+async function ensureTailwindCli(cwd) {
+  if (!isInteractive() || isAgentMode()) {
+    throw new Error(
+      "Standalone CSS export requires @tailwindcss/cli. Install it as a dev dependency in your project."
     );
   }
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/([^/'"]+)\/\1([^'"]*)['"]/g,
-    `from '@/${aliasComponents}/$1$2'`
-  );
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/([^'"]+)['"]/g,
-    `from '@/${aliasComponents}/$1'`
-  );
-  return transformed;
-}
-async function installItem(cwd, item, options, config2, substrateKinds = []) {
-  const installedFiles = [];
-  let skipped = false;
-  let filesToInstall = item.files;
-  if (item.type === "ui") {
-    const target = getComponentTarget(config2);
-    const selection = selectFilesForFramework(item.files, target);
-    filesToInstall = selection.files;
-    if (selection.fallback) {
-      log({
-        event: "add:fallback",
-        component: item.name,
-        target,
-        message: `No ${targetToExtension(target)} version available for ${item.name}. Installing React version.`
-      });
-    }
-    const hasComponentFile = selection.files.some((f) => !isSharedFile(f.path));
-    if (!hasComponentFile) {
-      throw new Error(
-        `No ${targetToExtension(target)} version available for "${item.name}" and no compatible fallback exists.`
-      );
-    }
-  } else if (item.type === "composite") {
-    filesToInstall = selectCompositeFiles(item.files, getComponentTarget(config2));
+  const shouldInstall = await confirm({
+    message: "Standalone CSS requires @tailwindcss/cli. Install it now?",
+    default: true
+  });
+  if (!shouldInstall) {
+    throw new Error("Standalone CSS export requires @tailwindcss/cli.");
   }
-  for (const file2 of filesToInstall) {
-    const projectPath2 = item.type === "substrate" ? substrateProjectPath(file2.path, config2, cwd) : transformPath(file2.path, config2, cwd);
-    const targetPath = join7(cwd, projectPath2);
-    if (fileExists(cwd, projectPath2)) {
-      if (!options.overwrite) {
-        log({
-          event: "add:skip",
-          component: item.name,
-          file: projectPath2,
-          reason: "exists"
-        });
-        skipped = true;
-        continue;
-      }
-    }
-    await mkdir2(dirname(targetPath), { recursive: true });
-    const fileType = item.type === "primitive" ? "primitive" : item.type === "substrate" ? "substrate" : "component";
-    const transformedContent = transformFileContent(file2.content, config2, fileType, cwd, {
-      substrateKinds,
-      installPath: file2.path
-    });
-    await writeFile2(targetPath, transformedContent, "utf-8");
-    installedFiles.push(projectPath2);
+  await updateDependencies([], ["@tailwindcss/cli"], { cwd });
+  if (!isTailwindCliInstalled()) {
+    throw new Error(
+      "@tailwindcss/cli was installed but cannot be resolved. Try installing at the workspace root."
+    );
   }
-  return {
-    installed: installedFiles.length > 0,
-    skipped,
-    files: installedFiles
-  };
 }
-async function add(componentArgs, options) {
-  setAgentMode(options.agent ?? false);
-  let components = componentArgs;
-  const cwd = process.cwd();
-  const config2 = await loadConfig(cwd);
-  const client = new RegistryClient(resolveRegistryUrl(options, config2));
-  let folder;
-  const firstArg = components[0];
-  if (firstArg && FOLDER_NAMES.has(firstArg)) {
-    folder = firstArg;
-    components = components.slice(1);
-  }
-  if (options.list) {
-    const availableComponents = await client.listComponents();
-    const availableComposites = await client.listComposites();
-    if (options.agent) {
-      log({
-        event: "add:list",
-        components: availableComponents,
-        composites: availableComposites
-      });
-    } else {
-      console.log("Available components:\n");
-      for (const comp of availableComponents) {
-        console.log(`  ${comp.name}  ${comp.description ?? ""}`);
-      }
-      if (availableComposites.length > 0) {
-        console.log("\nAvailable composites:\n");
-        for (const comp of availableComposites) {
-          console.log(`  ${comp.name}  ${comp.description ?? ""}`);
-        }
-      }
-    }
-    return;
+async function generateOutputs(cwd, paths, registry2, exports, source, darkMode = "class", config2) {
+  const contentSources = config2 ? resolveContentSources(cwd, config2) : [];
+  if (exports.compiled && !isTailwindCliInstalled()) {
+    log({ event: "init:prompting_exports" });
+    await ensureTailwindCli(cwd);
   }
-  const initialized = await isInitialized(cwd);
-  if (!initialized) {
-    error46("Project not initialized. Run `rafters init` first.");
-    process.exitCode = 1;
-    return;
+  if (exports.compiled) {
+    log({ event: "init:compiling_css" });
   }
-  if (options.update) {
-    options.overwrite = true;
+  return regenerateOutputs(registry2, {
+    outputDir: paths.output,
+    exports,
+    contentSources,
+    darkMode,
+    includeImport: source !== "shadcn"
+  });
+}
+async function regenerateFromExisting(cwd, paths, source, isAgentMode2, framework) {
+  log({ event: "init:regenerate", cwd });
+  let existingConfig = null;
+  try {
+    const configContent = await readFile3(paths.config, "utf-8");
+    existingConfig = migrateConfig(
+      JSON.parse(configContent)
+    );
+  } catch {
   }
-  let untrackedNames = [];
-  if (options.updateAll) {
-    options.overwrite = true;
-    if (!config2) {
-      error46("No rafters config found. Run 'rafters init' first.");
-      process.exitCode = 1;
-      return;
-    }
-    const trackedNames = getInstalledNames(config2);
-    untrackedNames = await discoverUntrackedNames(cwd, config2, client, trackedNames);
-    const candidates = [.../* @__PURE__ */ new Set([...trackedNames, ...untrackedNames])].sort();
-    if (candidates.length === 0) {
-      error46("No installed components found. Use 'rafters add <component>' to install first.");
-      process.exitCode = 1;
-      return;
-    }
-    if (untrackedNames.length > 0) {
-      log({
-        event: "add:untracked",
-        components: untrackedNames,
-        message: `Found ${untrackedNames.length} component(s) on disk the config never tracked: ${untrackedNames.join(", ")}. Refreshing and tracking them.`
-      });
-    }
-    components = candidates;
+  if (framework !== "unknown" && existingConfig) {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    existingConfig.framework = framework;
+    existingConfig.componentsPath = frameworkPaths.components;
+    existingConfig.primitivesPath = frameworkPaths.primitives;
+    existingConfig.compositesPath = frameworkPaths.composites;
+    existingConfig.rulesPath = frameworkPaths.rules;
   }
-  if (folder === "composites" && components.length === 0) {
-    components = ["composites"];
-  }
-  if (components.length === 0) {
-    error46("No components specified. Usage: rafters add <component...>");
-    process.exitCode = 1;
-    return;
+  await rm(join7(paths.tokens, "elevation.rafters.json"), { force: true });
+  await rm(join7(paths.tokens, "fill.rafters.json"), { force: true });
+  const registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS);
+  if (registry2.size() === 0) {
+    throw new Error("No tokens found. Cannot regenerate without existing tokens.");
   }
+  const namespaces = [...new Set(registry2.list().map((t) => t.namespace))];
   log({
-    event: "add:start",
-    cwd,
-    components,
-    overwrite: options.overwrite ?? false
+    event: "init:loaded",
+    tokenCount: registry2.size(),
+    namespaces
   });
-  const allItems = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const itemName of components) {
-    try {
-      if (folder === "composites") {
-        if (!seen.has(itemName)) {
-          const composite = await client.fetchComposite(itemName);
-          seen.add(itemName);
-          allItems.push(composite);
-          for (const dep of composite.primitives) {
-            if (!seen.has(dep)) {
-              const depItems = await client.resolveDependencies(dep, seen);
-              allItems.push(...depItems);
-            }
-          }
-        }
-      } else {
-        const items = await client.resolveDependencies(itemName, seen);
-        allItems.push(...items);
-      }
-    } catch (err) {
-      if (err instanceof Error) {
-        error46(err.message);
-      } else {
-        error46(`Failed to fetch "${itemName}"`);
-      }
-      process.exitCode = 1;
-      return;
+  let exports;
+  if (isAgentMode2) {
+    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
+  } else {
+    if (isInteractive()) {
+      log({ event: "init:prompting_exports" });
     }
+    exports = await promptExportFormats(existingConfig?.exports);
+    log({ event: "init:exports_selected", exports });
   }
-  const substrateKinds = [
-    ...new Set(
-      allItems.filter((item) => item.type === "substrate").map((item) => item.files[0]?.path.split("/")[0]).filter((segment) => Boolean(segment))
-    )
-  ];
-  const written = [];
-  const skipped = [];
-  const failed = [];
-  const installedItems = [];
-  const filteredItems = [];
-  const target = getComponentTarget(config2);
-  for (const item of allItems) {
-    if (!options.overwrite && isAlreadyInstalled(config2, item)) {
-      if (isInstalledOnDisk(config2, item, cwd)) {
-        log({
-          event: "add:skip",
-          component: item.name,
-          reason: "already installed"
-        });
-        skipped.push(item.name);
-        continue;
-      }
-      log({
-        event: "add:warning",
-        component: item.name,
-        message: "Config tracks this as installed but no files found on disk -- reinstalling."
-      });
-    }
-    try {
-      const result = await installItem(cwd, item, options, config2, substrateKinds);
-      if (result.installed) {
-        written.push(item.name);
-        installedItems.push(item);
-        if (item.type === "ui") {
-          const selection = selectFilesForFramework(item.files, target);
-          filteredItems.push({ ...item, files: selection.files });
-        } else {
-          filteredItems.push(item);
-        }
-        log({
-          event: "add:installed",
-          component: item.name,
-          type: item.type,
-          files: result.files
-        });
-      }
-      if (result.skipped && !result.installed) {
-        skipped.push(item.name);
-        installedItems.push(item);
-      }
-    } catch (err) {
-      failed.push(item.name);
-      if (err instanceof Error) {
-        log({
-          event: "add:warning",
-          component: item.name,
-          message: err.message
-        });
-      }
-    }
+  await mkdir2(paths.output, { recursive: true });
+  const outputs = await generateOutputs(
+    cwd,
+    paths,
+    registry2,
+    exports,
+    source,
+    "class",
+    existingConfig
+  );
+  if (existingConfig) {
+    existingConfig.exports = exports;
+    await writeFile2(paths.config, JSON.stringify(existingConfig, null, 2));
+  } else {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    const newConfig = {
+      framework,
+      componentsPath: frameworkPaths.components,
+      primitivesPath: frameworkPaths.primitives,
+      compositesPath: frameworkPaths.composites,
+      rulesPath: frameworkPaths.rules,
+      cssPath: null,
+      ...source ? { source } : {},
+      intent: "efficient",
+      fonts: { path: null, imports: [] },
+      exports,
+      installed: { components: [], primitives: [], composites: [], rules: [] }
+    };
+    await writeFile2(paths.config, JSON.stringify(newConfig, null, 2));
   }
-  const emptyDeps = {
-    installed: [],
-    skipped: [],
-    devInstalled: [],
-    failed: []
-  };
-  let depsResult = emptyDeps;
+  log({
+    event: "init:complete",
+    outputs,
+    path: paths.output
+  });
+}
+async function resetToDefaults(cwd, paths, source, isAgentMode2, framework) {
+  log({ event: "init:reset", cwd });
+  let existingConfig = null;
   try {
-    depsResult = await installRegistryDependencies(filteredItems, cwd, { target });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    log({
-      event: "add:deps:install-failed",
-      message: `Failed to process dependencies: ${message}`,
-      dependencies: [],
-      suggestion: "Check package.json and try installing dependencies manually."
-    });
+    const configContent = await readFile3(paths.config, "utf-8");
+    existingConfig = migrateConfig(
+      JSON.parse(configContent)
+    );
+  } catch {
   }
-  if (depsResult.installed.length > 0 || depsResult.skipped.length > 0) {
+  if (framework !== "unknown" && existingConfig) {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    existingConfig.framework = framework;
+    existingConfig.componentsPath = frameworkPaths.components;
+    existingConfig.primitivesPath = frameworkPaths.primitives;
+    existingConfig.compositesPath = frameworkPaths.composites;
+    existingConfig.rulesPath = frameworkPaths.rules;
+  }
+  let existingTokens = [];
+  try {
+    existingTokens = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS).list();
+  } catch {
+  }
+  const overriddenTokens = existingTokens.filter((t) => t.userOverride);
+  if (overriddenTokens.length > 0) {
+    const backup = {
+      resetAt: (/* @__PURE__ */ new Date()).toISOString(),
+      reason: "rafters init --reset",
+      overrides: overriddenTokens.map((t) => ({
+        name: t.name,
+        value: t.value,
+        userOverride: t.userOverride,
+        namespace: t.namespace
+      }))
+    };
+    await mkdir2(paths.output, { recursive: true });
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const backupPath = join7(paths.output, `reset-${timestamp}.json`);
+    await writeFile2(backupPath, JSON.stringify(backup, null, 2));
     log({
-      event: "add:dependencies",
-      dependencies: depsResult.installed,
-      devDependencies: depsResult.devInstalled,
-      skipped: depsResult.skipped
+      event: "init:reset_backup",
+      path: backupPath,
+      overrideCount: overriddenTokens.length
     });
   }
-  if (installedItems.length > 0 && config2) {
-    trackInstalled(config2, installedItems);
-    await saveConfig(cwd, config2);
-    await regenerateAfterInstall(cwd, config2);
-  } else if (installedItems.length > 0 && !config2) {
+  let exports;
+  if (isAgentMode2) {
+    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
+  } else {
+    if (isInteractive()) {
+      log({ event: "init:prompting_exports" });
+    }
+    exports = await promptExportFormats(existingConfig?.exports);
+    log({ event: "init:exports_selected", exports });
+  }
+  const system = generateBaseSystem({});
+  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS);
+  log({
+    event: "init:reset_generated",
+    tokenCount: registry2.size()
+  });
+  await rm(paths.tokens, { recursive: true, force: true });
+  await mkdir2(paths.tokens, { recursive: true });
+  saveRegistryToDir(paths.tokens, registry2);
+  const allTokensToSave = registry2.list();
+  const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
+  log({
+    event: "init:registry_saved",
+    path: paths.tokens,
+    namespaceCount
+  });
+  await mkdir2(paths.output, { recursive: true });
+  const outputs = await generateOutputs(
+    cwd,
+    paths,
+    registry2,
+    exports,
+    source,
+    "class",
+    existingConfig
+  );
+  if (existingConfig) {
+    existingConfig.exports = exports;
+    await writeFile2(paths.config, JSON.stringify(existingConfig, null, 2));
+  } else {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
     const newConfig = {
-      framework: "unknown",
-      componentsPath: "components/ui",
-      primitivesPath: "lib/primitives",
-      compositesPath: "composites",
-      rulesPath: "lib/rules",
+      framework,
+      componentsPath: frameworkPaths.components,
+      primitivesPath: frameworkPaths.primitives,
+      compositesPath: frameworkPaths.composites,
+      rulesPath: frameworkPaths.rules,
       cssPath: null,
-      shadcn: false,
-      exports: DEFAULT_EXPORTS,
+      ...source ? { source } : {},
+      intent: "efficient",
+      fonts: { path: null, imports: [] },
+      exports,
       installed: { components: [], primitives: [], composites: [], rules: [] }
     };
-    trackInstalled(newConfig, installedItems);
-    await saveConfig(cwd, newConfig);
-    await regenerateAfterInstall(cwd, newConfig);
+    await writeFile2(paths.config, JSON.stringify(newConfig, null, 2));
   }
   log({
-    event: "add:complete",
-    written: written.length,
-    skipped: skipped.length,
-    untracked: untrackedNames.length,
-    failed: failed.length,
-    components: written,
-    skippedComponents: skipped,
-    untrackedComponents: untrackedNames,
-    failedComponents: failed
+    event: "init:complete",
+    outputs,
+    path: paths.output
   });
-  if (failed.length > 0) {
-    process.exitCode = 1;
-  }
-  if (!options.updateAll && skipped.length > 0 && written.length === 0) {
+}
+async function init(options) {
+  setAgentMode(options.agent ?? false);
+  const isAgentMode2 = options.agent ?? false;
+  const cwd = process.cwd();
+  const paths = getRaftersPaths(cwd);
+  log({ event: "init:start", cwd });
+  const project = await detectProject(cwd);
+  const { framework: detectedFramework, shadcn, tailwindVersion, astroHasReact } = project;
+  const source = shadcn ? "shadcn" : void 0;
+  log({
+    event: "init:detected",
+    framework: detectedFramework,
+    tailwindVersion,
+    hasShadcn: !!shadcn
+  });
+  const framework = await resolveFramework(detectedFramework, options.framework, isAgentMode2);
+  if (framework !== detectedFramework) {
     log({
-      event: "add:hint",
-      message: "Some components were skipped. Use --update to re-fetch, or --update-all to refresh everything.",
-      skipped
+      event: "init:framework_resolved",
+      detected: detectedFramework,
+      resolved: framework,
+      source: options.framework ? "flag" : "prompt"
     });
-    error46("Component already exists. Use --update to re-fetch from registry.");
-    process.exitCode = 1;
   }
-}
-
-// src/commands/init.ts
-import { existsSync as existsSync4 } from "fs";
-import { copyFile, mkdir as mkdir3, readFile as readFile4, rm, writeFile as writeFile3 } from "fs/promises";
-import { createRequire } from "module";
-import { join as join8, relative as relative2 } from "path";
-import { checkbox, confirm, select } from "@inquirer/prompts";
-var REGISTRY_PLUGINS2 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
-async function backupCss(cssPath) {
-  const backupPath = cssPath.replace(/\.css$/, ".backup.css");
-  await copyFile(cssPath, backupPath);
-  return backupPath;
-}
-function cleanSourceCssBlocks(content) {
-  function parseBlocks(src) {
-    const blocks = [];
-    let depth = 0;
-    const headerStack = [];
-    let segmentStart = 0;
-    for (let i = 0; i < src.length; i++) {
-      const ch = src.charAt(i);
-      if (ch === "{") {
-        headerStack.push(segmentStart);
-        depth++;
-        if (depth >= 1) {
-          blocks.push({
-            headerStart: segmentStart,
-            bodyStart: i + 1,
-            end: -1,
-            header: src.slice(segmentStart, i).trim()
-          });
-        }
-        segmentStart = i + 1;
-      } else if (ch === "}") {
-        depth--;
-        const open = blocks.slice().reverse().find((b2) => b2.end === -1);
-        if (open) open.end = i + 1;
-        headerStack.pop();
-        segmentStart = i + 1;
-      } else if (ch === ";") {
-        segmentStart = i + 1;
-      }
-    }
-    return blocks.filter((b2) => b2.end !== -1);
+  if (isTailwindV3(tailwindVersion)) {
+    throw new Error("Tailwind v3 detected. Rafters requires Tailwind v4.");
   }
-  function isContentEmpty(body) {
-    return body.replace(/\/\*[\s\S]*?\*\//g, "").trim().length === 0;
+  const raftersExists = existsSync3(paths.root);
+  if (options.reset && !raftersExists) {
+    throw new Error("Nothing to reset. No .rafters/ directory found.");
   }
-  let out = content;
-  for (let pass = 0; pass < 10; pass++) {
-    const blocks = parseBlocks(out);
-    let edited = false;
-    for (const block of blocks.sort((a2, b2) => b2.headerStart - a2.headerStart)) {
-      const header = block.header;
-      if (/^@theme\s+inline$/.test(header)) {
-        out = out.slice(0, block.headerStart) + out.slice(block.end);
-        edited = true;
-        break;
-      }
-      if (header === ":root" || /(^|,)\s*:root\s*$/.test(header)) {
-        const body = out.slice(block.bodyStart, block.end - 1);
-        const cleanedBody = body.replace(/--[\w-]+\s*:[^;{}]*;?/g, "");
-        if (isContentEmpty(cleanedBody)) {
-          out = out.slice(0, block.headerStart) + out.slice(block.end);
-          edited = true;
-          break;
-        }
-        if (cleanedBody !== body) {
-          out = out.slice(0, block.bodyStart) + cleanedBody + out.slice(block.end - 1);
-          edited = true;
-          break;
-        }
-        continue;
-      }
-      if (header.startsWith("@media") || header.startsWith("@supports")) {
-        const body = out.slice(block.bodyStart, block.end - 1);
-        if (isContentEmpty(body)) {
-          out = out.slice(0, block.headerStart) + out.slice(block.end);
-          edited = true;
-          break;
-        }
-      }
-    }
-    if (!edited) break;
+  if (raftersExists && options.reset) {
+    await resetToDefaults(cwd, paths, source, isAgentMode2, framework);
+    return;
   }
-  return out.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
-}
-async function stripImportedDeclarations(cwd, cssPath, importedNames) {
-  if (importedNames.length === 0) return;
-  const fullPath = join8(cwd, cssPath);
-  const content = await readFile4(fullPath, "utf-8");
-  const pattern = new RegExp(importedNames.map((n2) => `^\\s*--${n2}[^;]*;\\s*$`).join("|"), "gm");
-  const cleaned = cleanSourceCssBlocks(content.replace(pattern, ""));
-  const collapsed = cleaned.replace(/\n{3,}/g, "\n\n");
-  await writeFile3(fullPath, collapsed);
-}
-async function updateMainCss(cwd, cssPath, themePath) {
-  const fullCssPath = join8(cwd, cssPath);
-  const cssContent = await readFile4(fullCssPath, "utf-8");
-  const cssDir = join8(cwd, cssPath, "..");
-  const themeFullPath = join8(cwd, themePath);
-  const relativeThemePath = relative2(cssDir, themeFullPath);
-  if (cssContent.includes(".rafters/output/rafters.css")) {
-    log({ event: "init:css_already_imported", cssPath });
+  if (raftersExists && !options.rebuild) {
+    throw new Error(
+      ".rafters/ directory already exists. Use --rebuild to regenerate output files, or --reset to start from defaults."
+    );
+  }
+  if (raftersExists && options.rebuild) {
+    await regenerateFromExisting(cwd, paths, source, isAgentMode2, framework);
     return;
   }
-  await backupCss(fullCssPath);
-  let newContent;
-  if (cssContent.includes('@import "tailwindcss"')) {
-    newContent = cssContent.replace('@import "tailwindcss";', `@import "${relativeThemePath}";`);
-  } else if (cssContent.includes("@import 'tailwindcss'")) {
-    newContent = cssContent.replace("@import 'tailwindcss';", `@import "${relativeThemePath}";`);
+  let exports;
+  if (isAgentMode2) {
+    exports = DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
   } else {
-    newContent = `@import "${relativeThemePath}";
-
-${cssContent}`;
-  }
-  await writeFile3(fullCssPath, newContent);
-  log({
-    event: "init:css_updated",
-    cssPath,
-    themePath: relativeThemePath
-  });
-}
-function isInteractive() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-function resolveSourceCssPath(cwd, framework, detectedFramework, projectCssPath, shadcnCssPath, emit) {
-  if (shadcnCssPath) {
-    if (existsSync4(join8(cwd, shadcnCssPath))) return shadcnCssPath;
-    const fallback = framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
-    emit({
-      event: "init:shadcn_css_missing",
-      configuredPath: shadcnCssPath,
-      fallbackPath: fallback,
-      message: "components.json points at a CSS file that does not exist. Falling back to the framework canonical location."
-    });
-    return fallback;
+    if (isInteractive()) {
+      log({ event: "init:prompting_exports" });
+    }
+    exports = await promptExportFormats();
+    log({ event: "init:exports_selected", exports });
   }
-  return framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
-}
-function slugifyFontName(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
-function isFontStackValue(value) {
-  if (typeof value !== "string") return false;
-  if (value.startsWith("var(")) return false;
-  if (/[,'"]/.test(value)) return true;
-  return /\b(sans-serif|serif|monospace|cursive|fantasy|system-ui|ui-(?:sans-serif|serif|monospace|rounded))\b/.test(
-    value
+  const adapter = getAdapter(source ?? "tailwind");
+  const baseConfig = {};
+  const sourceCssPathForBase = resolveSourceCssPath(
+    cwd,
+    framework,
+    detectedFramework,
+    project.cssPath,
+    shadcn?.tailwind?.css,
+    log
   );
-}
-async function resolveFramework(detected, flag, agentMode) {
-  if (flag) {
-    if (!isSelectableFramework(flag)) {
-      throw new Error(
-        `Unknown --framework "${flag}". Valid values: ${SELECTABLE_FRAMEWORKS.join(", ")}.`
-      );
+  if (sourceCssPathForBase !== null) {
+    try {
+      const cssForBase = await readFile3(join7(cwd, sourceCssPathForBase), "utf-8");
+      const baseSlots = [
+        {
+          detect: () => adapter.detectSpacing(cssForBase).base,
+          field: "baseSpacingUnit",
+          event: "init:import_spacing_applied",
+          eventKey: "baseSpacingUnit"
+        },
+        {
+          detect: () => adapter.detectRadius(cssForBase).base,
+          field: "baseRadiusOverride",
+          event: "init:import_radius_applied",
+          eventKey: "baseRadius"
+        },
+        {
+          detect: () => adapter.detectFontSize(cssForBase).base,
+          field: "baseFontSizeOverride",
+          event: "init:import_font_size_applied",
+          eventKey: "baseFontSize"
+        },
+        {
+          detect: () => adapter.detectFocusRing(cssForBase).width,
+          field: "focusRingWidthOverride",
+          event: "init:import_focus_ring_applied",
+          eventKey: "focusRingWidth"
+        }
+        // Motion duration is intentionally not imported -- rafters' motion
+        // system is research-backed and most projects' `--duration-base`
+        // values are unresearched defaults. See importers/bases.ts for the
+        // policy note; designers can `rafters set motion-duration-base ...`
+        // after init to override explicitly.
+      ];
+      for (const slot of baseSlots) {
+        const value = slot.detect();
+        if (value === void 0) continue;
+        baseConfig[slot.field] = value;
+        log({
+          event: slot.event,
+          cssPath: sourceCssPathForBase,
+          [slot.eventKey]: value
+        });
+      }
+    } catch (err) {
+      if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
     }
-    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((value) => ({
-      name: FRAMEWORK_SPECS[value].label ?? value,
-      value
-    }))
+  const system = generateBaseSystem(baseConfig);
+  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS);
+  log({
+    event: "init:generated",
+    tokenCount: registry2.size()
   });
-  return picked;
-}
-async function promptExportFormats(existingConfig) {
-  if (!isInteractive()) {
-    return existingConfig ?? DEFAULT_EXPORTS;
-  }
-  const choices = EXPORT_CHOICES.map((choice) => ({
-    name: choice.name,
-    value: choice.value,
-    checked: existingConfig ? existingConfig[choice.value] : choice.checked
-  }));
-  const allChoices = [
-    ...choices,
-    ...FUTURE_EXPORTS.map((choice) => ({
-      name: `${choice.name} (${choice.disabled})`,
-      value: choice.value,
-      checked: false,
-      disabled: true
-    }))
-  ];
-  const selections = await checkbox({
-    message: "What would you like to export?",
-    choices: allChoices,
-    required: true
-  });
-  return selectionsToConfig(selections);
-}
-function isTailwindCliInstalled() {
-  const require2 = createRequire(import.meta.url);
-  try {
-    require2.resolve("@tailwindcss/cli/package.json");
-    return true;
-  } catch (err) {
-    if (err instanceof Error && "code" in err && err.code === "MODULE_NOT_FOUND") {
-      return false;
-    }
-    throw err;
-  }
-}
-async function ensureTailwindCli(cwd) {
-  if (!isInteractive() || isAgentMode()) {
-    throw new Error(
-      "Standalone CSS export requires @tailwindcss/cli. Install it as a dev dependency in your project."
-    );
-  }
-  const shouldInstall = await confirm({
-    message: "Standalone CSS requires @tailwindcss/cli. Install it now?",
-    default: true
-  });
-  if (!shouldInstall) {
-    throw new Error("Standalone CSS export requires @tailwindcss/cli.");
-  }
-  await updateDependencies([], ["@tailwindcss/cli"], { cwd });
-  if (!isTailwindCliInstalled()) {
-    throw new Error(
-      "@tailwindcss/cli was installed but cannot be resolved. Try installing at the workspace root."
-    );
-  }
-}
-async function generateOutputs(cwd, paths, registry2, exports, shadcn, darkMode = "class", config2) {
-  const contentSources = config2 ? resolveContentSources(cwd, config2) : [];
-  if (exports.compiled && !isTailwindCliInstalled()) {
-    log({ event: "init:prompting_exports" });
-    await ensureTailwindCli(cwd);
-  }
-  if (exports.compiled) {
-    log({ event: "init:compiling_css" });
-  }
-  return regenerateOutputs(registry2, {
-    outputDir: paths.output,
-    exports,
-    contentSources,
-    darkMode,
-    includeImport: !shadcn
-  });
-}
-async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode2, framework) {
-  log({ event: "init:regenerate", cwd });
-  let existingConfig = null;
-  try {
-    const configContent = await readFile4(paths.config, "utf-8");
-    existingConfig = JSON.parse(configContent);
-  } catch {
-  }
-  if (framework !== "unknown" && existingConfig) {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    existingConfig.framework = framework;
-    existingConfig.componentsPath = frameworkPaths.components;
-    existingConfig.primitivesPath = frameworkPaths.primitives;
-    existingConfig.compositesPath = frameworkPaths.composites;
-    existingConfig.rulesPath = frameworkPaths.rules;
-  }
-  await rm(join8(paths.tokens, "elevation.rafters.json"), { force: true });
-  await rm(join8(paths.tokens, "fill.rafters.json"), { force: true });
-  const registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2);
-  if (registry2.size() === 0) {
-    throw new Error("No tokens found. Cannot regenerate without existing tokens.");
-  }
-  const namespaces = [...new Set(registry2.list().map((t) => t.namespace))];
-  log({
-    event: "init:loaded",
-    tokenCount: registry2.size(),
-    namespaces
-  });
-  let exports;
-  if (isAgentMode2) {
-    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
-    log({ event: "init:exports_default", exports });
-  } else {
-    if (isInteractive()) {
-      log({ event: "init:prompting_exports" });
-    }
-    exports = await promptExportFormats(existingConfig?.exports);
-    log({ event: "init:exports_selected", exports });
-  }
-  await mkdir3(paths.output, { recursive: true });
-  const outputs = await generateOutputs(
-    cwd,
-    paths,
-    registry2,
-    exports,
-    shadcn,
-    "class",
-    existingConfig
-  );
-  if (existingConfig) {
-    existingConfig.exports = exports;
-    await writeFile3(paths.config, JSON.stringify(existingConfig, null, 2));
-  } else {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    const newConfig = {
-      framework,
-      componentsPath: frameworkPaths.components,
-      primitivesPath: frameworkPaths.primitives,
-      compositesPath: frameworkPaths.composites,
-      rulesPath: frameworkPaths.rules,
-      cssPath: null,
-      shadcn: !!shadcn,
-      exports,
-      installed: { components: [], primitives: [], composites: [], rules: [] }
-    };
-    await writeFile3(paths.config, JSON.stringify(newConfig, null, 2));
-  }
-  log({
-    event: "init:complete",
-    outputs,
-    path: paths.output
-  });
-}
-async function resetToDefaults(cwd, paths, shadcn, isAgentMode2, framework) {
-  log({ event: "init:reset", cwd });
-  let existingConfig = null;
-  try {
-    const configContent = await readFile4(paths.config, "utf-8");
-    existingConfig = JSON.parse(configContent);
-  } catch {
-  }
-  if (framework !== "unknown" && existingConfig) {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    existingConfig.framework = framework;
-    existingConfig.componentsPath = frameworkPaths.components;
-    existingConfig.primitivesPath = frameworkPaths.primitives;
-    existingConfig.compositesPath = frameworkPaths.composites;
-    existingConfig.rulesPath = frameworkPaths.rules;
-  }
-  let existingTokens = [];
-  try {
-    existingTokens = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2).list();
-  } catch {
-  }
-  const overriddenTokens = existingTokens.filter((t) => t.userOverride);
-  if (overriddenTokens.length > 0) {
-    const backup = {
-      resetAt: (/* @__PURE__ */ new Date()).toISOString(),
-      reason: "rafters init --reset",
-      overrides: overriddenTokens.map((t) => ({
-        name: t.name,
-        value: t.value,
-        userOverride: t.userOverride,
-        namespace: t.namespace
-      }))
-    };
-    await mkdir3(paths.output, { recursive: true });
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const backupPath = join8(paths.output, `reset-${timestamp}.json`);
-    await writeFile3(backupPath, JSON.stringify(backup, null, 2));
-    log({
-      event: "init:reset_backup",
-      path: backupPath,
-      overrideCount: overriddenTokens.length
-    });
-  }
-  let exports;
-  if (isAgentMode2) {
-    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
-    log({ event: "init:exports_default", exports });
-  } else {
-    if (isInteractive()) {
-      log({ event: "init:prompting_exports" });
-    }
-    exports = await promptExportFormats(existingConfig?.exports);
-    log({ event: "init:exports_selected", exports });
-  }
-  const system = generateBaseSystem({});
-  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS2);
-  log({
-    event: "init:reset_generated",
-    tokenCount: registry2.size()
-  });
-  await rm(paths.tokens, { recursive: true, force: true });
-  await mkdir3(paths.tokens, { recursive: true });
+  await mkdir2(paths.tokens, { recursive: true });
+  await mkdir2(paths.output, { recursive: true });
   saveRegistryToDir(paths.tokens, registry2);
   const allTokensToSave = registry2.list();
   const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
@@ -30244,183 +29989,26 @@ async function resetToDefaults(cwd, paths, shadcn, isAgentMode2, framework) {
     path: paths.tokens,
     namespaceCount
   });
-  await mkdir3(paths.output, { recursive: true });
-  const outputs = await generateOutputs(
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, source);
+  let detectedCssPath = null;
+  detectedCssPath = resolveSourceCssPath(
     cwd,
-    paths,
-    registry2,
-    exports,
-    shadcn,
-    "class",
-    existingConfig
+    framework,
+    detectedFramework,
+    project.cssPath,
+    shadcn?.tailwind?.css,
+    log
   );
-  if (existingConfig) {
-    existingConfig.exports = exports;
-    await writeFile3(paths.config, JSON.stringify(existingConfig, null, 2));
-  } else {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    const newConfig = {
-      framework,
-      componentsPath: frameworkPaths.components,
-      primitivesPath: frameworkPaths.primitives,
-      compositesPath: frameworkPaths.composites,
-      rulesPath: frameworkPaths.rules,
-      cssPath: null,
-      shadcn: !!shadcn,
-      exports,
-      installed: { components: [], primitives: [], composites: [], rules: [] }
-    };
-    await writeFile3(paths.config, JSON.stringify(newConfig, null, 2));
-  }
-  log({
-    event: "init:complete",
-    outputs,
-    path: paths.output
-  });
-}
-async function init(options) {
-  setAgentMode(options.agent ?? false);
-  const isAgentMode2 = options.agent ?? false;
-  const cwd = process.cwd();
-  const paths = getRaftersPaths(cwd);
-  log({ event: "init:start", cwd });
-  const project = await detectProject(cwd);
-  const { framework: detectedFramework, shadcn, tailwindVersion, astroHasReact } = project;
-  log({
-    event: "init:detected",
-    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.");
-  }
-  const raftersExists = existsSync4(paths.root);
-  if (options.reset && !raftersExists) {
-    throw new Error("Nothing to reset. No .rafters/ directory found.");
-  }
-  if (raftersExists && options.reset) {
-    await resetToDefaults(cwd, paths, shadcn, isAgentMode2, framework);
-    return;
-  }
-  if (raftersExists && !options.rebuild) {
-    throw new Error(
-      ".rafters/ directory already exists. Use --rebuild to regenerate output files, or --reset to start from defaults."
-    );
-  }
-  if (raftersExists && options.rebuild) {
-    await regenerateFromExisting(cwd, paths, shadcn, isAgentMode2, framework);
-    return;
-  }
-  let exports;
-  if (isAgentMode2) {
-    exports = DEFAULT_EXPORTS;
-    log({ event: "init:exports_default", exports });
-  } else {
-    if (isInteractive()) {
-      log({ event: "init:prompting_exports" });
-    }
-    exports = await promptExportFormats();
-    log({ event: "init:exports_selected", exports });
-  }
-  const baseConfig = {};
-  const sourceCssPathForBase = resolveSourceCssPath(
-    cwd,
-    framework,
-    detectedFramework,
-    project.cssPath,
-    shadcn?.tailwind?.css,
-    log
-  );
-  if (sourceCssPathForBase !== null) {
-    try {
-      const cssForBase = await readFile4(join8(cwd, sourceCssPathForBase), "utf-8");
-      const baseSlots = [
-        {
-          detect: detectSpacingBase,
-          field: "baseSpacingUnit",
-          event: "init:import_spacing_applied",
-          eventKey: "baseSpacingUnit"
-        },
-        {
-          detect: detectRadiusBase,
-          field: "baseRadiusOverride",
-          event: "init:import_radius_applied",
-          eventKey: "baseRadius"
-        },
-        {
-          detect: detectFontSizeBase,
-          field: "baseFontSizeOverride",
-          event: "init:import_font_size_applied",
-          eventKey: "baseFontSize"
-        },
-        {
-          detect: detectFocusRingWidth,
-          field: "focusRingWidthOverride",
-          event: "init:import_focus_ring_applied",
-          eventKey: "focusRingWidth"
-        }
-        // Motion duration is intentionally not imported -- rafters' motion
-        // system is research-backed and most projects' `--duration-base`
-        // values are unresearched defaults. See importers/bases.ts for the
-        // policy note; designers can `rafters set motion-duration-base ...`
-        // after init to override explicitly.
-      ];
-      for (const slot of baseSlots) {
-        const value = slot.detect(cssForBase);
-        if (value === null) continue;
-        baseConfig[slot.field] = value;
-        log({ event: slot.event, cssPath: sourceCssPathForBase, [slot.eventKey]: value });
-      }
-    } catch (err) {
-      if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
-    }
-  }
-  const system = generateBaseSystem(baseConfig);
-  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS2);
-  log({
-    event: "init:generated",
-    tokenCount: registry2.size()
-  });
-  await mkdir3(paths.tokens, { recursive: true });
-  await mkdir3(paths.output, { recursive: true });
-  saveRegistryToDir(paths.tokens, registry2);
-  const allTokensToSave = registry2.list();
-  const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
-  log({
-    event: "init:registry_saved",
-    path: paths.tokens,
-    namespaceCount
-  });
-  const outputs = await generateOutputs(cwd, paths, registry2, exports, shadcn);
-  let detectedCssPath = null;
-  detectedCssPath = resolveSourceCssPath(
-    cwd,
-    framework,
-    detectedFramework,
-    project.cssPath,
-    shadcn?.tailwind?.css,
-    log
-  );
-  if (!shadcn && exports.tailwind) {
-    if (detectedCssPath) {
-      await updateMainCss(cwd, detectedCssPath, ".rafters/output/rafters.css");
-    } else {
-      log({
-        event: "init:css_not_found",
-        message: 'No main CSS file found. Add @import ".rafters/output/rafters.css" manually.',
-        searchedLocations: FRAMEWORK_SPECS[framework].cssLocations
-      });
-    }
+  if (source !== "shadcn" && exports.tailwind) {
+    if (detectedCssPath) {
+      await updateMainCss(cwd, detectedCssPath, ".rafters/output/rafters.css");
+    } else {
+      log({
+        event: "init:css_not_found",
+        message: 'No main CSS file found. Add @import ".rafters/output/rafters.css" manually.',
+        searchedLocations: FRAMEWORK_SPECS[framework].cssLocations
+      });
+    }
   }
   let componentTarget = frameworkToTarget(framework);
   if (framework === "astro" && astroHasReact && isInteractive() && !isAgentMode2) {
@@ -30441,14 +30029,16 @@ async function init(options) {
   const frameworkPaths = FRAMEWORK_SPECS[framework].components;
   const config2 = {
     framework,
+    ...source ? { source } : {},
     componentTarget,
     componentsPath: frameworkPaths.components,
     primitivesPath: frameworkPaths.primitives,
     compositesPath: frameworkPaths.composites,
     rulesPath: frameworkPaths.rules,
     cssPath: detectedCssPath,
-    shadcn: !!shadcn,
     exports,
+    intent: "efficient",
+    fonts: { path: null, imports: [] },
     installed: {
       components: [],
       primitives: [],
@@ -30456,11 +30046,11 @@ async function init(options) {
       rules: []
     }
   };
-  await writeFile3(paths.config, JSON.stringify(config2, null, 2));
+  await writeFile2(paths.config, JSON.stringify(config2, null, 2));
   if (detectedCssPath) {
     let sourceCss = null;
     try {
-      sourceCss = await readFile4(join8(cwd, detectedCssPath), "utf-8");
+      sourceCss = await readFile3(join7(cwd, detectedCssPath), "utf-8");
     } catch (err) {
       if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
     }
@@ -30473,7 +30063,7 @@ async function init(options) {
           ...summary
         });
         const classification = classifyDeclarations(extractShadcnRoot(sourceCss));
-        const colorDecls = colorsFromClassification(classification);
+        const colorDecls = adapter.detectColors(sourceCss);
         const nonColorDecls = [
           ...classification.byNamespace.typography,
           ...classification.byNamespace.spacing,
@@ -30517,7 +30107,7 @@ async function init(options) {
             }
           }
           saveRegistryToDir(paths.tokens, registry2);
-          await generateOutputs(cwd, paths, registry2, exports, shadcn);
+          await generateOutputs(cwd, paths, registry2, exports, source);
           const importedNames = [
             ...toImportColors.map((c4) => c4.name),
             ...toImportNonColors.map((d2) => d2.name)
@@ -30549,7 +30139,10 @@ async function init(options) {
               familySeeds.set(baseName, { seed: oklch2, seedPosition });
             }
           }
-          const families = Array.from(familySeeds, ([name, info]) => ({ name, ...info }));
+          const families = Array.from(familySeeds, ([name, info]) => ({
+            name,
+            ...info
+          }));
           if (families.length > 0) {
             for (const family of families) {
               for (const t of importColorFamily(family.name, family.seedPosition, family.seed)) {
@@ -30592,7 +30185,10 @@ async function init(options) {
               if (!family) continue;
               const position = isAgentMode2 ? family.seedPosition : await select({
                 message: `Which position in "${familyChoice}" for "${role}"?`,
-                choices: SCALE_POSITIONS.map((p2) => ({ name: p2, value: p2 })),
+                choices: SCALE_POSITIONS.map((p2) => ({
+                  name: p2,
+                  value: p2
+                })),
                 default: family.seedPosition
               });
               registry2.set(
@@ -30605,7 +30201,7 @@ async function init(options) {
               assignments.push({ role, family: familyChoice, position });
             }
             saveRegistryToDir(paths.tokens, registry2);
-            await generateOutputs(cwd, paths, registry2, exports, shadcn);
+            await generateOutputs(cwd, paths, registry2, exports, source);
             const themeImportedNames = families.flatMap(
               (f) => SCALE_POSITIONS.map((p2) => `color-${f.name}-${p2}`).concat([`color-${f.name}`])
             );
@@ -30621,7 +30217,7 @@ async function init(options) {
       }
     }
     if (sourceCss !== null) {
-      const detectedFonts = detectFonts(sourceCss);
+      const detectedFonts = adapter.detectFonts(sourceCss);
       if (detectedFonts.length > 0) {
         const typographyTokens = registry2.list({ namespace: "typography" });
         const baseFamilyNames = new Set(
@@ -30696,27 +30292,564 @@ async function init(options) {
               registry2.set(base, font.stack, { reason });
             }
           }
-          fontAssignments.push({ role, family: font.name });
+          fontAssignments.push({ role, family: font.name });
+        }
+        if (fontAssignments.length > 0 || definedFonts.length > 0) {
+          saveRegistryToDir(paths.tokens, registry2);
+          await generateOutputs(cwd, paths, registry2, exports, source);
+          log({
+            event: "init:import_fonts_applied",
+            cssPath: detectedCssPath,
+            fontsDetected: detectedFonts.map((f) => f.name),
+            assignments: fontAssignments,
+            ...definedFonts.length > 0 ? { definedFonts } : {}
+          });
+        }
+      }
+    }
+  }
+  log({
+    event: "init:complete",
+    outputs: [...outputs, "config.rafters.json"],
+    path: paths.output
+  });
+}
+
+// src/commands/add.ts
+var REGISTRY_PLUGINS2 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
+async function regenerateAfterInstall(cwd, config2) {
+  const paths = getRaftersPaths(cwd);
+  let registry2;
+  try {
+    registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2);
+  } catch {
+    return;
+  }
+  if (registry2.size() === 0) return;
+  try {
+    await regenerateOutputs(registry2, {
+      outputDir: paths.output,
+      exports: config2.exports,
+      contentSources: resolveContentSources(cwd, config2),
+      darkMode: config2.darkMode ?? "class",
+      includeImport: config2.source !== "shadcn"
+    });
+  } catch (err) {
+    log({
+      event: "add:regen-failed",
+      message: `Output regeneration failed: ${err instanceof Error ? err.message : String(err)}`
+    });
+  }
+}
+async function isInitialized(cwd) {
+  const paths = getRaftersPaths(cwd);
+  try {
+    await access(paths.root);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function loadConfig(cwd) {
+  const paths = getRaftersPaths(cwd);
+  try {
+    const content = await readFile4(paths.config, "utf-8");
+    return migrateConfig(
+      JSON.parse(content)
+    );
+  } catch (err) {
+    if (existsSync4(paths.config)) {
+      const message = err instanceof Error ? err.message : String(err);
+      log({
+        event: "add:warning",
+        message: `Failed to load config: ${message}`
+      });
+    }
+    return null;
+  }
+}
+function resolveRegistryUrl(options, config2) {
+  return options.registryUrl ?? config2?.registryUrl;
+}
+async function saveConfig(cwd, config2) {
+  const paths = getRaftersPaths(cwd);
+  await writeFile3(paths.config, JSON.stringify(config2, null, 2));
+}
+function getInstalledNames(config2) {
+  if (!config2?.installed) return [];
+  const names = /* @__PURE__ */ new Set([
+    ...config2.installed.components,
+    ...config2.installed.primitives,
+    ...config2.installed.composites ?? [],
+    ...config2.installed.rules ?? [],
+    ...config2.installed.substrate ?? []
+  ]);
+  return [...names].sort();
+}
+async function discoverUntrackedNames(cwd, config2, client, tracked) {
+  let index = null;
+  try {
+    index = await client.fetchIndex();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log({
+      event: "add:warning",
+      message: `Could not read the registry index to reconcile on-disk components (${message}). Updating tracked components only.`
+    });
+  }
+  const { untracked } = buildUpdateCandidates(tracked, index, readInstallRoots(cwd, config2));
+  return untracked;
+}
+function getComponentTarget(config2) {
+  return resolveComponentTarget(config2);
+}
+var SHARED_EXTENSIONS = /* @__PURE__ */ new Set([".behavior.ts", ".classes.ts"]);
+function isSharedFile(path) {
+  for (const ext of SHARED_EXTENSIONS) {
+    if (path.endsWith(ext)) return true;
+  }
+  return false;
+}
+var REACT_FALLBACK_TARGETS = /* @__PURE__ */ new Set(["astro", "vue", "svelte"]);
+function selectFilesForFramework(files, target) {
+  const preferredExt = targetToExtension(target);
+  const shared = files.filter((f) => isSharedFile(f.path));
+  const matched = files.filter((f) => f.path.endsWith(preferredExt));
+  if (matched.length > 0) {
+    return { files: [...matched, ...shared], fallback: false };
+  }
+  if (REACT_FALLBACK_TARGETS.has(target)) {
+    const fallbackFiles = files.filter((f) => f.path.endsWith(".tsx"));
+    if (fallbackFiles.length > 0) {
+      return { files: [...fallbackFiles, ...shared], fallback: true };
+    }
+  }
+  if (target !== "react" && !REACT_FALLBACK_TARGETS.has(target)) {
+    return { files: shared, fallback: false };
+  }
+  return { files, fallback: false };
+}
+var TARGET_GATED_COMPOSITE_FILES = [{ suffix: "Composite.astro", target: "astro" }];
+function selectCompositeFiles(files, target) {
+  return files.filter((file2) => {
+    const gate = TARGET_GATED_COMPOSITE_FILES.find((g2) => file2.path.endsWith(g2.suffix));
+    return gate ? gate.target === target : true;
+  });
+}
+var FOLDER_NAMES = /* @__PURE__ */ new Set(["composites"]);
+function isAlreadyInstalled(config2, item) {
+  if (!config2?.installed) return false;
+  const { components, primitives, composites: composites2, rules, substrate } = config2.installed;
+  const bucketByType = {
+    ui: components,
+    primitive: primitives,
+    composite: composites2 ?? [],
+    rule: rules ?? [],
+    substrate: substrate ?? []
+  };
+  return bucketByType[item.type].includes(item.name);
+}
+function isInstalledOnDisk(config2, item, cwd) {
+  if (!isAlreadyInstalled(config2, item)) return false;
+  const filesToCheck = item.type === "ui" ? selectFilesForFramework(item.files, getComponentTarget(config2)).files : item.files;
+  for (const file2 of filesToCheck) {
+    if (fileExists(cwd, transformPath(file2.path, config2, cwd))) return true;
+  }
+  return false;
+}
+function trackInstalled(config2, items) {
+  if (!config2.installed) {
+    config2.installed = {
+      components: [],
+      primitives: [],
+      composites: [],
+      rules: []
+    };
+  }
+  const installed = config2.installed;
+  if (!installed.composites) installed.composites = [];
+  if (!installed.rules) installed.rules = [];
+  if (!installed.substrate) installed.substrate = [];
+  const bucketByType = {
+    ui: installed.components,
+    primitive: installed.primitives,
+    composite: installed.composites,
+    rule: installed.rules,
+    substrate: installed.substrate
+  };
+  for (const item of items) {
+    const bucket = bucketByType[item.type];
+    if (!bucket.includes(item.name)) bucket.push(item.name);
+  }
+  installed.components.sort();
+  installed.primitives.sort();
+  installed.composites.sort();
+  installed.rules.sort();
+  installed.substrate.sort();
+}
+function rootFor(field, cwd, fallback) {
+  return field === void 0 ? fallback : resolveRoot(field, cwd, fallback);
+}
+function transformPath(registryPath, config2, cwd = process.cwd()) {
+  if (!config2) return registryPath;
+  const replacements = [
+    ["components/ui/", config2.componentsPath, "components/ui"],
+    ["lib/primitives/", config2.primitivesPath, "lib/primitives"],
+    ["composites/", config2.compositesPath, "composites"],
+    ["rules/", config2.rulesPath, "lib/rules"]
+  ];
+  for (const [prefix, field, fallback] of replacements) {
+    if (registryPath.startsWith(prefix)) {
+      return registryPath.replace(prefix, `${rootFor(field, cwd, fallback)}/`);
+    }
+  }
+  return registryPath;
+}
+function substrateProjectPath(registryPath, config2, cwd = process.cwd()) {
+  const componentsResolved = rootFor(config2?.componentsPath, cwd, "components/ui");
+  const sourceRoot = componentsResolved.replace(/\/?components\/ui$/, "");
+  return sourceRoot ? join8(sourceRoot, registryPath) : registryPath;
+}
+function fileExists(cwd, relativePath) {
+  return existsSync4(join8(cwd, relativePath));
+}
+function transformFileContent(content, config2, fileType = "component", cwd = process.cwd(), opts = {}) {
+  const { substrateKinds = [], installPath } = opts;
+  let transformed = content;
+  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);
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/\.\.\/primitives\/([^'"]+)['"]/g,
+    `from '@/${aliasPrimitives}/$1'`
+  );
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/primitives\/([^'"]+)['"]/g,
+    `from '@/${aliasPrimitives}/$1'`
+  );
+  const substrateOwnDir = fileType === "substrate" && installPath ? stripSourceRoot(dirname(installPath)) : null;
+  const aliasSibling = fileType === "primitive" ? aliasPrimitives : substrateOwnDir ?? aliasComponents;
+  transformed = transformed.replace(/from\s+['"]\.\/([^'"]+)['"]/g, `from '@/${aliasSibling}/$1'`);
+  if (substrateKinds.length > 0) {
+    const kindAlternation = substrateKinds.join("|");
+    transformed = transformed.replace(
+      new RegExp(`from\\s+['"](?:\\.\\./){1,2}(${kindAlternation})/([^'"]+)['"]`, "g"),
+      "from '@/$1/$2'"
+    );
+  }
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/([^/'"]+)\/\1([^'"]*)['"]/g,
+    `from '@/${aliasComponents}/$1$2'`
+  );
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/([^'"]+)['"]/g,
+    `from '@/${aliasComponents}/$1'`
+  );
+  return transformed;
+}
+async function installItem(cwd, item, options, config2, substrateKinds = []) {
+  const installedFiles = [];
+  let skipped = false;
+  let filesToInstall = item.files;
+  if (item.type === "ui") {
+    const target = getComponentTarget(config2);
+    const selection = selectFilesForFramework(item.files, target);
+    filesToInstall = selection.files;
+    if (selection.fallback) {
+      log({
+        event: "add:fallback",
+        component: item.name,
+        target,
+        message: `No ${targetToExtension(target)} version available for ${item.name}. Installing React version.`
+      });
+    }
+    const hasComponentFile = selection.files.some((f) => !isSharedFile(f.path));
+    if (!hasComponentFile) {
+      throw new Error(
+        `No ${targetToExtension(target)} version available for "${item.name}" and no compatible fallback exists.`
+      );
+    }
+  } else if (item.type === "composite") {
+    filesToInstall = selectCompositeFiles(item.files, getComponentTarget(config2));
+  }
+  for (const file2 of filesToInstall) {
+    const projectPath2 = item.type === "substrate" ? substrateProjectPath(file2.path, config2, cwd) : transformPath(file2.path, config2, cwd);
+    const targetPath = join8(cwd, projectPath2);
+    if (fileExists(cwd, projectPath2)) {
+      if (!options.overwrite) {
+        log({
+          event: "add:skip",
+          component: item.name,
+          file: projectPath2,
+          reason: "exists"
+        });
+        skipped = true;
+        continue;
+      }
+    }
+    await mkdir3(dirname(targetPath), { recursive: true });
+    const fileType = item.type === "primitive" ? "primitive" : item.type === "substrate" ? "substrate" : "component";
+    const transformedContent = transformFileContent(file2.content, config2, fileType, cwd, {
+      substrateKinds,
+      installPath: file2.path
+    });
+    await writeFile3(targetPath, transformedContent, "utf-8");
+    installedFiles.push(projectPath2);
+  }
+  return {
+    installed: installedFiles.length > 0,
+    skipped,
+    files: installedFiles
+  };
+}
+async function add(componentArgs, options) {
+  setAgentMode(options.agent ?? false);
+  let components = componentArgs;
+  const cwd = process.cwd();
+  const config2 = await loadConfig(cwd);
+  const client = new RegistryClient(resolveRegistryUrl(options, config2));
+  let folder;
+  const firstArg = components[0];
+  if (firstArg && FOLDER_NAMES.has(firstArg)) {
+    folder = firstArg;
+    components = components.slice(1);
+  }
+  if (options.list) {
+    const availableComponents = await client.listComponents();
+    const availableComposites = await client.listComposites();
+    if (options.agent) {
+      log({
+        event: "add:list",
+        components: availableComponents,
+        composites: availableComposites
+      });
+    } else {
+      console.log("Available components:\n");
+      for (const comp of availableComponents) {
+        console.log(`  ${comp.name}  ${comp.description ?? ""}`);
+      }
+      if (availableComposites.length > 0) {
+        console.log("\nAvailable composites:\n");
+        for (const comp of availableComposites) {
+          console.log(`  ${comp.name}  ${comp.description ?? ""}`);
+        }
+      }
+    }
+    return;
+  }
+  const initialized = await isInitialized(cwd);
+  if (!initialized) {
+    error46("Project not initialized. Run `rafters init` first.");
+    process.exitCode = 1;
+    return;
+  }
+  if (options.update) {
+    options.overwrite = true;
+  }
+  let untrackedNames = [];
+  if (options.updateAll) {
+    options.overwrite = true;
+    if (!config2) {
+      error46("No rafters config found. Run 'rafters init' first.");
+      process.exitCode = 1;
+      return;
+    }
+    const trackedNames = getInstalledNames(config2);
+    untrackedNames = await discoverUntrackedNames(cwd, config2, client, trackedNames);
+    const candidates = [.../* @__PURE__ */ new Set([...trackedNames, ...untrackedNames])].sort();
+    if (candidates.length === 0) {
+      error46("No installed components found. Use 'rafters add <component>' to install first.");
+      process.exitCode = 1;
+      return;
+    }
+    if (untrackedNames.length > 0) {
+      log({
+        event: "add:untracked",
+        components: untrackedNames,
+        message: `Found ${untrackedNames.length} component(s) on disk the config never tracked: ${untrackedNames.join(", ")}. Refreshing and tracking them.`
+      });
+    }
+    components = candidates;
+  }
+  if (folder === "composites" && components.length === 0) {
+    components = ["composites"];
+  }
+  if (components.length === 0) {
+    error46("No components specified. Usage: rafters add <component...>");
+    process.exitCode = 1;
+    return;
+  }
+  log({
+    event: "add:start",
+    cwd,
+    components,
+    overwrite: options.overwrite ?? false
+  });
+  const allItems = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const itemName of components) {
+    try {
+      if (folder === "composites") {
+        if (!seen.has(itemName)) {
+          const composite = await client.fetchComposite(itemName);
+          seen.add(itemName);
+          allItems.push(composite);
+          for (const dep of composite.primitives) {
+            if (!seen.has(dep)) {
+              const depItems = await client.resolveDependencies(dep, seen);
+              allItems.push(...depItems);
+            }
+          }
         }
-        if (fontAssignments.length > 0 || definedFonts.length > 0) {
-          saveRegistryToDir(paths.tokens, registry2);
-          await generateOutputs(cwd, paths, registry2, exports, shadcn);
-          log({
-            event: "init:import_fonts_applied",
-            cssPath: detectedCssPath,
-            fontsDetected: detectedFonts.map((f) => f.name),
-            assignments: fontAssignments,
-            ...definedFonts.length > 0 ? { definedFonts } : {}
-          });
+      } else {
+        const items = await client.resolveDependencies(itemName, seen);
+        allItems.push(...items);
+      }
+    } catch (err) {
+      if (err instanceof Error) {
+        error46(err.message);
+      } else {
+        error46(`Failed to fetch "${itemName}"`);
+      }
+      process.exitCode = 1;
+      return;
+    }
+  }
+  const substrateKinds = [
+    ...new Set(
+      allItems.filter((item) => item.type === "substrate").map((item) => item.files[0]?.path.split("/")[0]).filter((segment) => Boolean(segment))
+    )
+  ];
+  const written = [];
+  const skipped = [];
+  const failed = [];
+  const installedItems = [];
+  const filteredItems = [];
+  const target = getComponentTarget(config2);
+  for (const item of allItems) {
+    if (!options.overwrite && isAlreadyInstalled(config2, item)) {
+      if (isInstalledOnDisk(config2, item, cwd)) {
+        log({
+          event: "add:skip",
+          component: item.name,
+          reason: "already installed"
+        });
+        skipped.push(item.name);
+        continue;
+      }
+      log({
+        event: "add:warning",
+        component: item.name,
+        message: "Config tracks this as installed but no files found on disk -- reinstalling."
+      });
+    }
+    try {
+      const result = await installItem(cwd, item, options, config2, substrateKinds);
+      if (result.installed) {
+        written.push(item.name);
+        installedItems.push(item);
+        if (item.type === "ui") {
+          const selection = selectFilesForFramework(item.files, target);
+          filteredItems.push({ ...item, files: selection.files });
+        } else {
+          filteredItems.push(item);
         }
+        log({
+          event: "add:installed",
+          component: item.name,
+          type: item.type,
+          files: result.files
+        });
+      }
+      if (result.skipped && !result.installed) {
+        skipped.push(item.name);
+        installedItems.push(item);
+      }
+    } catch (err) {
+      failed.push(item.name);
+      if (err instanceof Error) {
+        log({
+          event: "add:warning",
+          component: item.name,
+          message: err.message
+        });
       }
     }
   }
+  const emptyDeps = {
+    installed: [],
+    skipped: [],
+    devInstalled: [],
+    failed: []
+  };
+  let depsResult = emptyDeps;
+  try {
+    depsResult = await installRegistryDependencies(filteredItems, cwd, {
+      target
+    });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log({
+      event: "add:deps:install-failed",
+      message: `Failed to process dependencies: ${message}`,
+      dependencies: [],
+      suggestion: "Check package.json and try installing dependencies manually."
+    });
+  }
+  if (depsResult.installed.length > 0 || depsResult.skipped.length > 0) {
+    log({
+      event: "add:dependencies",
+      dependencies: depsResult.installed,
+      devDependencies: depsResult.devInstalled,
+      skipped: depsResult.skipped
+    });
+  }
+  if (installedItems.length > 0 && config2) {
+    trackInstalled(config2, installedItems);
+    await saveConfig(cwd, config2);
+    await regenerateAfterInstall(cwd, config2);
+  } else if (installedItems.length > 0 && !config2) {
+    const newConfig = {
+      framework: "unknown",
+      componentsPath: "components/ui",
+      primitivesPath: "lib/primitives",
+      compositesPath: "composites",
+      rulesPath: "lib/rules",
+      cssPath: null,
+      intent: "efficient",
+      fonts: { path: null, imports: [] },
+      exports: DEFAULT_EXPORTS,
+      installed: { components: [], primitives: [], composites: [], rules: [] }
+    };
+    trackInstalled(newConfig, installedItems);
+    await saveConfig(cwd, newConfig);
+    await regenerateAfterInstall(cwd, newConfig);
+  }
   log({
-    event: "init:complete",
-    outputs: [...outputs, "config.rafters.json"],
-    path: paths.output
+    event: "add:complete",
+    written: written.length,
+    skipped: skipped.length,
+    untracked: untrackedNames.length,
+    failed: failed.length,
+    components: written,
+    skippedComponents: skipped,
+    untrackedComponents: untrackedNames,
+    failedComponents: failed
   });
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+  if (!options.updateAll && skipped.length > 0 && written.length === 0) {
+    log({
+      event: "add:hint",
+      message: "Some components were skipped. Use --update to re-fetch, or --update-all to refresh everything.",
+      skipped
+    });
+    error46("Component already exists. Use --update to re-fetch from registry.");
+    process.exitCode = 1;
+  }
 }
 
 // src/commands/mcp.ts
@@ -30891,7 +31024,7 @@ function fuzzyScore(query, target) {
 
 // ../composites/src/registry.ts
 var composites = /* @__PURE__ */ new Map();
-function register2(composite) {
+function register3(composite) {
   const { id } = composite.manifest;
   if (composites.has(id)) {
     throw new Error(`Composite "${id}" is already registered`);
@@ -31233,7 +31366,10 @@ var RaftersToolHandler = class {
           text: JSON.stringify({
             error: "workspace parameter required",
             suggestion: "Multiple workspaces are available. Pass `workspace` with one of the names below.",
-            workspaces: this.workspaces.map((w) => ({ name: w.name, root: w.root }))
+            workspaces: this.workspaces.map((w) => ({
+              name: w.name,
+              root: w.root
+            }))
           })
         }
       ]
@@ -31270,7 +31406,7 @@ var RaftersToolHandler = class {
     const { registry: registry2 } = await discoverFromDirs(...dirs);
     for (const composite of registry2.values()) {
       try {
-        register2(composite);
+        register3(composite);
       } catch {
       }
     }
@@ -31298,7 +31434,9 @@ var RaftersToolHandler = class {
     const paths = getRaftersPaths(workspaceRoot);
     let config2 = null;
     try {
-      config2 = JSON.parse(await readFile6(paths.config, "utf-8"));
+      config2 = migrateConfig(
+        JSON.parse(await readFile6(paths.config, "utf-8"))
+      );
     } catch {
     }
     if (!config2?.compositesPath) {
@@ -31342,7 +31480,9 @@ var RaftersToolHandler = class {
       // are listed -- the array is empty when nothing is constrained.
       blockRules: c4.blocks.filter((b2) => b2.rules && b2.rules.length > 0).map((b2) => ({ id: b2.id, type: b2.type, rules: b2.rules }))
     }));
-    return { content: [{ type: "text", text: JSON.stringify({ composites: result }, null, 2) }] };
+    return {
+      content: [{ type: "text", text: JSON.stringify({ composites: result }, null, 2) }]
+    };
   }
   async handlePattern(args) {
     const { solves, query, workspace } = args;
@@ -31389,7 +31529,9 @@ var RaftersToolHandler = class {
       cognitiveLoad: c4.manifest.cognitiveLoad,
       usagePatterns: c4.manifest.usagePatterns
     }));
-    return { content: [{ type: "text", text: JSON.stringify({ patterns }, null, 2) }] };
+    return {
+      content: [{ type: "text", text: JSON.stringify({ patterns }, null, 2) }]
+    };
   }
   async handleComponent(componentName) {
     try {
@@ -31508,8 +31650,8 @@ import { existsSync as existsSync8 } from "fs";
 import { resolve as resolve6 } from "path";
 
 // ../studio/src/api/vite-plugin.ts
-import { readFile as readFile7 } from "fs/promises";
-import { join as join14 } from "path";
+import { readFile as readFile7, writeFile as writeFile4 } from "fs/promises";
+import { isAbsolute as isAbsolute3, join as join14 } from "path";
 var REGISTRY_PLUGINS3 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
 var STUDIO_REASON_DEFAULT = "studio interactive edit";
 var TokenResponseSchema = external_exports.object({
@@ -31537,13 +31679,52 @@ var ColorBuildOptionsSchema = external_exports.object({
 var projectPath = process.env.RAFTERS_PROJECT_PATH || process.cwd();
 var outputDir = join14(projectPath, ".rafters", "output");
 var configPath = join14(projectPath, ".rafters", "config.rafters.json");
-async function loadStudioConfig() {
+var FontsConfigSchema = external_exports.object({
+  path: external_exports.union([external_exports.string(), external_exports.null()]).optional(),
+  imports: external_exports.array(external_exports.string()).optional()
+});
+var RaftersConfigSchema = external_exports.object({
+  intent: external_exports.string().optional(),
+  fonts: FontsConfigSchema.optional(),
+  source: external_exports.string().optional(),
+  darkMode: external_exports.enum(["class", "media"]).optional(),
+  framework: external_exports.string().optional(),
+  cssPath: external_exports.union([external_exports.string(), external_exports.null()]).optional(),
+  exports: external_exports.record(external_exports.string(), external_exports.boolean()).optional()
+}).passthrough();
+var KNOWN_INTENTS = ["efficient"];
+async function readRaftersConfig() {
   try {
-    return JSON.parse(await readFile7(configPath, "utf8"));
+    const raw = JSON.parse(await readFile7(configPath, "utf8"));
+    if ("shadcn" in raw && !("source" in raw)) {
+      if (raw.shadcn === true) raw.source = "shadcn";
+      delete raw.shadcn;
+    }
+    const result = RaftersConfigSchema.safeParse(raw);
+    if (!result.success) {
+      console.log(`[rafters] Config validation failed: ${result.error.message}`);
+      return null;
+    }
+    return result.data;
   } catch {
     return null;
   }
 }
+function validateFontsPath(path) {
+  if (path === null || path === void 0) return null;
+  if (isAbsolute3(path)) return "fonts path must be relative";
+  return null;
+}
+function validateIntent(intent) {
+  if (!KNOWN_INTENTS.includes(intent)) {
+    return `unknown intent "${intent}". Known: ${KNOWN_INTENTS.join(", ")}`;
+  }
+  return null;
+}
+async function loadStudioConfig() {
+  const raw = await readRaftersConfig();
+  return raw;
+}
 var SetTokenMessageSchema = external_exports.object({
   name: external_exports.string().min(1),
   value: external_exports.union([external_exports.string(), ColorValueSchema, ColorReferenceSchema]),
@@ -31942,7 +32123,7 @@ function studioApiPlugin() {
             exports,
             contentSources: config2 ? resolveContentSources(projectPath, config2) : [],
             darkMode: config2?.darkMode ?? "class",
-            includeImport: !config2?.shadcn
+            includeImport: config2?.source !== "shadcn"
           },
           { notify: () => server.ws.send({ type: "custom", event: "rafters:css-updated" }) }
         );
@@ -32060,6 +32241,85 @@ function studioApiPlugin() {
           client.send("rafters:token-updated", { ok: false, error: String(error47) });
         }
       });
+      server.ws.on("rafters:get-config", async (_rawData, client) => {
+        const config2 = await readRaftersConfig();
+        if (!config2) {
+          client.send("rafters:config", {
+            ok: false,
+            error: `config not found at ${configPath}`
+          });
+          return;
+        }
+        client.send("rafters:config", { ok: true, config: config2 });
+      });
+      server.ws.on("rafters:set-intent", async (rawData, client) => {
+        const parsed = external_exports.object({ intent: external_exports.string().min(1) }).safeParse(rawData);
+        if (!parsed.success) {
+          client.send("rafters:intent-updated", {
+            ok: false,
+            error: `Invalid message: ${parsed.error.message}`
+          });
+          return;
+        }
+        const { intent } = parsed.data;
+        const intentError = validateIntent(intent);
+        if (intentError) {
+          client.send("rafters:intent-updated", { ok: false, error: intentError });
+          return;
+        }
+        const config2 = await readRaftersConfig();
+        if (!config2) {
+          client.send("rafters:intent-updated", {
+            ok: false,
+            error: `config not found at ${configPath}`
+          });
+          return;
+        }
+        const updated = { ...config2, intent };
+        try {
+          await writeFile4(configPath, JSON.stringify(updated, null, 2));
+          client.send("rafters:intent-updated", { ok: true, intent });
+        } catch (error47) {
+          console.log(`[rafters] Intent update failed: ${error47}`);
+          client.send("rafters:intent-updated", { ok: false, error: String(error47) });
+        }
+      });
+      server.ws.on("rafters:set-fonts", async (rawData, client) => {
+        const parsed = FontsConfigSchema.safeParse(rawData);
+        if (!parsed.success) {
+          client.send("rafters:fonts-updated", {
+            ok: false,
+            error: `Invalid message: ${parsed.error.message}`
+          });
+          return;
+        }
+        const fontsData = parsed.data;
+        const pathError = validateFontsPath(fontsData.path);
+        if (pathError) {
+          client.send("rafters:fonts-updated", { ok: false, error: pathError });
+          return;
+        }
+        const config2 = await readRaftersConfig();
+        if (!config2) {
+          client.send("rafters:fonts-updated", {
+            ok: false,
+            error: `config not found at ${configPath}`
+          });
+          return;
+        }
+        const existing = config2.fonts ?? {};
+        const fonts = { ...existing };
+        if (fontsData.path !== void 0) fonts.path = fontsData.path;
+        if (fontsData.imports !== void 0) fonts.imports = fontsData.imports;
+        const updated = { ...config2, fonts };
+        try {
+          await writeFile4(configPath, JSON.stringify(updated, null, 2));
+          client.send("rafters:fonts-updated", { ok: true, fonts });
+        } catch (error47) {
+          console.log(`[rafters] Fonts update failed: ${error47}`);
+          client.send("rafters:fonts-updated", { ok: false, error: String(error47) });
+        }
+      });
       server.middlewares.use(async (req, res, next) => {
         let pathname;
         try {