rafters 0.3.0 → 0.4.0

package/dist/index.js

@@ -82,7 +82,7 @@ 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 { basename, dirname, join as join6 } from "path";
+import { basename, dirname, join as join7 } from "path";
 
 // ../../node_modules/.pnpm/apca-w3@0.1.9/node_modules/apca-w3/src/apca-w3.js
 var SA98G = {
@@ -20309,6 +20309,11 @@ var MOTION_NAMESPACE_PROPERTY = {
 };
 var MOTION_NAMESPACE_NAMES = Object.keys(MOTION_NAMESPACE_PROPERTY);
 var REDUCED_MOTION_ZEROED = /* @__PURE__ */ new Set(["duration", "delay"]);
+var TAILWIND_THEME_PREFIX = {
+  duration: "transition-duration",
+  ease: "ease",
+  delay: "transition-delay"
+};
 var MOTION_NAMESPACE_TOKEN = new RegExp(`^rafters-(${MOTION_NAMESPACE_NAMES.join("|")})-(.+)$`);
 function motionNamespaceParts(name) {
   const match = MOTION_NAMESPACE_TOKEN.exec(name);
@@ -20565,6 +20570,11 @@ function generateThemeBlock(groups) {
     lines.push(bridgeLines);
     lines.push("");
   }
+  const animationKeys = generateMotionAnimationKeys(groups.motion);
+  if (animationKeys) {
+    lines.push(animationKeys);
+    lines.push("");
+  }
   if (groups.breakpoint.length > 0) {
     for (const token of groups.breakpoint) {
       const value = tokenValueToCSS(token);
@@ -20591,10 +20601,6 @@ function generateThemeBlock(groups) {
     }
     lines.push("");
   }
-  const animationTokens = generateAnimationTokens(groups.motion);
-  if (animationTokens) {
-    lines.push(animationTokens);
-  }
   lines.push("}");
   return lines.join("\n");
 }
@@ -20685,18 +20691,6 @@ function generateKeyframes(motionTokens) {
   }
   return lines.join("\n").trim();
 }
-function generateAnimationTokens(motionTokens) {
-  const animationTokens = motionTokens.filter((t) => t.name.startsWith("motion-animation-"));
-  if (animationTokens.length === 0) {
-    return "";
-  }
-  const lines = [];
-  for (const token of animationTokens) {
-    const animName = token.animationName || token.name.replace("motion-animation-", "");
-    lines.push(`  --animate-${animName}: ${token.value};`);
-  }
-  return lines.join("\n");
-}
 function generateDepthUtilities(depthTokens) {
   if (depthTokens.length === 0) return "";
   const lines = ["/* Depth (z-index) utilities -- words over numbers */"];
@@ -20791,8 +20785,8 @@ function generateMotionUtilities(motionTokens) {
     const className = token.name.replace("motion-semantic-", "motion-");
     lines.push(`@utility ${className} {`);
     lines.push(`  transition-property: ${spec.properties.join(", ")};`);
-    lines.push(`  transition-duration: var(--duration-${spec.durationTier});`);
-    lines.push(`  transition-timing-function: var(--ease-${spec.curve});`);
+    lines.push(`  transition-duration: var(--rafters-duration-${spec.durationTier});`);
+    lines.push(`  transition-timing-function: var(--rafters-ease-${spec.curve});`);
     if (spec.reducedMotion) {
       lines.push("  @media (prefers-reduced-motion: reduce) {");
       lines.push(`    transition-property: ${spec.reducedMotion.properties.join(", ")};`);
@@ -20848,7 +20842,7 @@ function parseCellSpec(tokenName, raw) {
     `tailwind exporter: motion cell token "${tokenName}" has an unrecognized duration.kind ${JSON.stringify(kind ?? null)}. Known duration.kind values: period, tier.`
   );
 }
-function generateMotionCellUtilities(motionTokens) {
+function generateMotionAnimationKeys(motionTokens) {
   const cellTokens = motionTokens.filter((t) => t.name.startsWith("motion-cell-"));
   if (cellTokens.length === 0) return "";
   const periodMembers = /* @__PURE__ */ new Set();
@@ -20856,38 +20850,38 @@ function generateMotionCellUtilities(motionTokens) {
     const parts = motionNamespaceParts(token.name);
     if (parts?.namespace === "period") periodMembers.add(parts.member);
   }
-  const lines = [
-    "/* Motion cells -- one utility per animated (component, part, transition) */"
-  ];
+  const keys = /* @__PURE__ */ new Map();
   for (const token of cellTokens) {
     if (typeof token.value !== "string") continue;
     const spec = parseCellSpec(token.name, token.value);
-    lines.push(`@utility ${token.name.replace("motion-cell-", "animate-")} {`);
     if (spec === null) {
-      lines.push(`  animation: ${token.value};`);
-    } else if (spec.duration.kind === "period") {
+      keys.set(token.name.replace("motion-cell-", ""), token.value);
+      continue;
+    }
+    if (spec.duration.kind === "period") {
       const { period } = spec.duration;
       if (!periodMembers.has(period)) {
         throw new Error(
           `tailwind exporter: motion cell token "${token.name}" references unknown period "${period}". Known periods: ${[...periodMembers].sort().join(", ")}.`
         );
       }
-      lines.push(`  animation-name: ${spec.keyframe};`);
-      lines.push(`  animation-duration: var(--rafters-period-${period});`);
-      lines.push("  animation-iteration-count: infinite;");
-    } else {
-      lines.push(`  animation-name: ${spec.keyframe};`);
-      lines.push(`  animation-duration: var(--rafters-duration-${spec.duration.tier});`);
-      lines.push(`  animation-timing-function: var(--rafters-ease-${spec.curve});`);
-    }
-    if (token.reducedMotionAware !== false) {
-      lines.push("  @media (prefers-reduced-motion: reduce) {");
-      lines.push("    animation-duration: 0s;");
-      lines.push("  }");
+      keys.set(
+        `${spec.keyframe}-${period}`,
+        `${spec.keyframe} var(--rafters-period-${period}) infinite`
+      );
+      continue;
     }
-    lines.push("}");
+    const { tier } = spec.duration;
+    keys.set(
+      `${spec.keyframe}-${tier}-${spec.curve}`,
+      `${spec.keyframe} var(--rafters-duration-${tier}) var(--rafters-ease-${spec.curve})`
+    );
   }
-  return lines.join("\n");
+  if (keys.size === 0) return "";
+  return [
+    "  /* Motion assignments -- one key per distinct (shape, tier, curve) */",
+    ...[...keys].map(([name, value]) => `  --animate-${name}: ${value};`)
+  ].join("\n");
 }
 function generateMotionNamespaceVars(motionTokens) {
   const lines = [];
@@ -20903,35 +20897,45 @@ function generateMotionNamespaceVars(motionTokens) {
     ...lines
   ].join("\n");
 }
+function generateReducedMotionLaw(motionTokens) {
+  const lines = [];
+  for (const token of motionTokens) {
+    const parts = motionNamespaceParts(token.name);
+    if (!parts || !REDUCED_MOTION_ZEROED.has(parts.namespace)) continue;
+    lines.push(`    --${token.name}: 0ms;`);
+  }
+  if (lines.length === 0) return "";
+  return [
+    "/* Reduced motion is law: every duration and delay is zero, loops are not. */",
+    "@media (prefers-reduced-motion: reduce) {",
+    "  :root {",
+    ...lines,
+    "  }",
+    "}"
+  ].join("\n");
+}
 function generateMotionBridgeVars(motionTokens) {
   const lines = [];
   for (const token of motionTokens) {
-    if (token.name.startsWith("motion-duration-") && token.name !== "motion-duration-base") {
-      const key = token.name.replace("motion-duration-", "");
-      lines.push(`  --duration-${key}: var(--rafters-duration-${key});`);
-    }
-    if (token.name.startsWith("motion-easing-")) {
-      const key = token.name.replace("motion-easing-", "");
-      lines.push(`  --ease-${key}: var(--rafters-ease-${key});`);
-    }
+    const parts = motionNamespaceParts(token.name);
+    if (!parts) continue;
+    const themePrefix = TAILWIND_THEME_PREFIX[parts.namespace];
+    if (!themePrefix) continue;
+    lines.push(`  --${themePrefix}-${parts.member}: var(--${token.name});`);
   }
   return lines.join("\n");
 }
 function generateMotionNamespaceUtilities(motionTokens) {
-  const lines = ["/* The five motion namespaces -- one utility per member */"];
+  const lines = ["/* Motion namespaces Tailwind has no theme key for */"];
   let emitted = 0;
   for (const token of motionTokens) {
     const parts = motionNamespaceParts(token.name);
     if (!parts) continue;
+    if (TAILWIND_THEME_PREFIX[parts.namespace]) continue;
     const property = MOTION_NAMESPACE_PROPERTY[parts.namespace];
     emitted++;
     lines.push(`@utility ${parts.namespace}-${parts.member} {`);
     lines.push(`  ${property}: var(--${token.name});`);
-    if (REDUCED_MOTION_ZEROED.has(parts.namespace)) {
-      lines.push("  @media (prefers-reduced-motion: reduce) {");
-      lines.push(`    ${property}: 0ms;`);
-      lines.push("  }");
-    }
     lines.push("}");
   }
   return emitted === 0 ? "" : lines.join("\n");
@@ -21001,6 +21005,11 @@ function tokensToTailwind(tokens, options = {}, typographyOverrides = []) {
   if (keyframes) {
     sections.push(keyframes);
   }
+  const reducedMotionLaw = generateReducedMotionLaw(groups.motion);
+  if (reducedMotionLaw) {
+    sections.push("");
+    sections.push(reducedMotionLaw);
+  }
   const typographyThemeInline = generateTypographyCompositeThemeInline(
     groups["typography-composite"]
   );
@@ -21028,11 +21037,6 @@ function tokensToTailwind(tokens, options = {}, typographyOverrides = []) {
     sections.push("");
     sections.push(motionUtilities);
   }
-  const cellUtilities = generateMotionCellUtilities(groups.motion);
-  if (cellUtilities) {
-    sections.push("");
-    sections.push(cellUtilities);
-  }
   const overrideCSS = generateTypographyOverrideCSS(typographyOverrides);
   if (overrideCSS) {
     sections.push("");
@@ -21054,8 +21058,8 @@ async function registryToCompiled(registry2, options = {}) {
 ${sourceDirectives}
 ${themeBody}`;
   const { execFileSync } = await import("child_process");
-  const { mkdtempSync, writeFileSync: writeFileSync2, readFileSync: readFileSync4, rmSync } = await import("fs");
-  const { join: join15, dirname: dirname4 } = await import("path");
+  const { mkdtempSync, writeFileSync: writeFileSync2, readFileSync: readFileSync5, rmSync } = await import("fs");
+  const { join: join16, dirname: dirname4 } = await import("path");
   const { createRequire: createRequire2 } = await import("module");
   const require2 = createRequire2(import.meta.url);
   let pkgDir;
@@ -21065,10 +21069,10 @@ ${themeBody}`;
   } catch {
     throw new Error("Failed to resolve @tailwindcss/cli");
   }
-  const binPath = join15(pkgDir, "dist", "index.mjs");
-  const tempDir = mkdtempSync(join15(pkgDir, ".tmp-compile-"));
-  const tempInput = join15(tempDir, "input.css");
-  const tempOutput = join15(tempDir, "output.css");
+  const binPath = join16(pkgDir, "dist", "index.mjs");
+  const tempDir = mkdtempSync(join16(pkgDir, ".tmp-compile-"));
+  const tempInput = join16(tempDir, "input.css");
+  const tempOutput = join16(tempDir, "output.css");
   try {
     writeFileSync2(tempInput, input);
     const args = [binPath, "-i", tempInput, "-o", tempOutput];
@@ -21076,7 +21080,7 @@ ${themeBody}`;
       args.push("--minify");
     }
     execFileSync("node", args, { stdio: "pipe", timeout: 3e4, cwd: pkgDir });
-    return readFileSync4(tempOutput, "utf-8");
+    return readFileSync5(tempOutput, "utf-8");
   } catch (error47) {
     const message = error47 instanceof Error ? error47.message : String(error47);
     throw new Error(`Failed to compile CSS: ${message}`);
@@ -21252,7 +21256,7 @@ async function registryToDocumentation(registry2, options = {}) {
   const themeBody = registryToTailwind(registry2, { includeImport: false });
   const candidates = deriveCandidates(themeBody);
   const { mkdtempSync, writeFileSync: writeFileSync2, rmSync } = await import("fs");
-  const { join: join15, dirname: dirname4 } = await import("path");
+  const { join: join16, dirname: dirname4 } = await import("path");
   const { createRequire: createRequire2 } = await import("module");
   const require2 = createRequire2(import.meta.url);
   let pkgDir;
@@ -21264,8 +21268,8 @@ async function registryToDocumentation(registry2, options = {}) {
       "Failed to resolve @tailwindcss/cli -- install it to generate documentation CSS"
     );
   }
-  const tempDir = mkdtempSync(join15(pkgDir, ".tmp-doc-compile-"));
-  const candidateFile = join15(tempDir, "candidates.txt");
+  const tempDir = mkdtempSync(join16(pkgDir, ".tmp-doc-compile-"));
+  const candidateFile = join16(tempDir, "candidates.txt");
   writeFileSync2(candidateFile, candidates.join("\n"));
   const sourceDirectives = [
     `@source "${candidateFile}";`,
@@ -21274,17 +21278,17 @@ async function registryToDocumentation(registry2, options = {}) {
   const input = `@import "tailwindcss" source(none);
 ${sourceDirectives}
 ${themeBody}`;
-  const tempInput = join15(tempDir, "input.css");
-  const tempOutput = join15(tempDir, "output.css");
+  const tempInput = join16(tempDir, "input.css");
+  const tempOutput = join16(tempDir, "output.css");
   try {
     writeFileSync2(tempInput, input);
     const { execFileSync } = await import("child_process");
-    const binPath = join15(pkgDir, "dist", "index.mjs");
+    const binPath = join16(pkgDir, "dist", "index.mjs");
     const args = [binPath, "-i", tempInput, "-o", tempOutput];
     if (minify) args.push("--minify");
     execFileSync("node", args, { stdio: "pipe", timeout: 6e4, cwd: pkgDir });
-    const { readFileSync: readFileSync4 } = await import("fs");
-    const raw = readFileSync4(tempOutput, "utf-8");
+    const { readFileSync: readFileSync5 } = await import("fs");
+    const raw = readFileSync5(tempOutput, "utf-8");
     return postProcessDocSheet(raw);
   } catch (error47) {
     const message = error47 instanceof Error ? error47.message : String(error47);
@@ -22294,6 +22298,28 @@ var DEFAULT_KEYFRAME_DEFINITIONS = {
     meaning: "Scale down while fading out",
     contexts: ["modal-exit", "popover-close"]
   },
+  "grow-in": {
+    // scaleY, not a uniform scale -- a bar growing from the baseline to its
+    // full height is STRUCTURAL geometry (fixed, like the accordion
+    // chevron's 180deg rotation), not a pop: no opacity, no other numeric.
+    // The transform-origin anchoring the growth at the bottom (the
+    // value-axis baseline) is the caller-set `transform-origin`
+    // (bar-chart.behavior.ts's `transformOriginFor`), not this keyframe --
+    // this declares only the scaleY 0 -> 1 extent.
+    css: () => "from { transform: scaleY(0); } to { transform: scaleY(1); }",
+    meaning: "Grow from zero to full height, anchored at the baseline (caller-set transform-origin)",
+    contexts: ["bar-chart", "value-display"]
+  },
+  "grow-in-x": {
+    // The horizontal-layout counterpart of grow-in: scaleX, not scaleY --
+    // `layout: 'horizontal'` swaps computeBars' value axis from y to x
+    // (bar-chart.behavior.ts), so the structural growth axis swaps with it.
+    // Same rationale as grow-in: no opacity, no other numeric, transform-
+    // origin is caller-set (transformOriginFor).
+    css: () => "from { transform: scaleX(0); } to { transform: scaleX(1); }",
+    meaning: "Grow from zero to full width, anchored at the baseline (caller-set transform-origin)",
+    contexts: ["bar-chart", "value-display"]
+  },
   spin: {
     css: () => "from { transform: rotate(0deg); } to { transform: rotate(360deg); }",
     meaning: "Continuous rotation",
@@ -22739,6 +22765,38 @@ var DEFAULT_MOTION_CELL_ANIMATIONS = {
     meaning: "The incoming tab panel as the selection moves: the calendar month-change moment on a panel instead of a grid, one tier quicker because a panel swap covers no distance.",
     contexts: ["tabs", "panel", "crossfade"]
   },
+  "bar-chart-bar-enter": {
+    keyframe: "grow-in",
+    duration: { kind: "tier", tier: "normal" },
+    curve: "enter",
+    cell: { component: "bar-chart", part: "bar", transition: "enter" },
+    meaning: "A bar arriving: grows from zero at the value-axis baseline (bar-chart.behavior.ts sets the transform-origin), on the arrival curve. Vertical layout, the default -- see bar-chart-bar-enter-x for the horizontal counterpart.",
+    contexts: ["bar-chart", "chart", "value-display"]
+  },
+  "bar-chart-bar-enter-x": {
+    keyframe: "grow-in-x",
+    duration: { kind: "tier", tier: "normal" },
+    curve: "enter",
+    cell: { component: "bar-chart", part: "bar", transition: "enter-horizontal" },
+    meaning: 'A bar arriving under layout: "horizontal": grows from zero at the value-axis baseline, now the left edge (bar-chart.behavior.ts sets the transform-origin), on the same arrival curve as the vertical bar-chart-bar-enter cell -- only the transform property (scaleX, not scaleY) changes with the swapped axis.',
+    contexts: ["bar-chart", "chart", "value-display"]
+  },
+  "area-chart-area-enter": {
+    keyframe: "fade-in",
+    duration: { kind: "tier", tier: "moderate" },
+    curve: "enter",
+    cell: { component: "area-chart", part: "area", transition: "enter" },
+    meaning: "A filled area arriving on mount: fade, not scale -- unlike bar-chart-bar-enter, a stacked area series has no single baseline edge to grow from (its baseline is the previous series own top curve, area-chart.behavior.ts computeAreas), so opacity is the one property every area shares whether overlaid or stacked.",
+    contexts: ["area-chart", "chart", "value-display"]
+  },
+  "line-chart-line-enter": {
+    keyframe: "fade-in",
+    duration: { kind: "tier", tier: "moderate" },
+    curve: "enter",
+    cell: { component: "line-chart", part: "line", transition: "enter" },
+    meaning: "A line series arriving on mount: fades in rather than snapping into place. The matrix assigns opacity over a stroke-dashoffset reveal for this cell -- a dashoffset keyframe needs a per-instance path-length value nothing here names, where a fade needs none.",
+    contexts: ["line-chart", "chart", "value-display"]
+  },
   // ------------------------------------------------------------- load / appearance
   "avatar-image-load": {
     keyframe: "fade-in",
@@ -27105,6 +27163,32 @@ function generateBaseSystem(config2 = {}) {
     }
   };
 }
+function generateNamespaces(namespaces, config2 = {}) {
+  const mergedConfig = {
+    ...DEFAULT_SYSTEM_CONFIG,
+    ...config2
+  };
+  const resolvedConfig = resolveConfig(mergedConfig);
+  const byNamespace = /* @__PURE__ */ new Map();
+  const allTokens = [];
+  const generators = createGeneratorDefs(mergedConfig.colorPaletteBases);
+  const requestedGenerators = generators.filter((g2) => namespaces.includes(g2.name));
+  for (const { generate: generate4 } of requestedGenerators) {
+    const result = generate4(resolvedConfig);
+    byNamespace.set(result.namespace, result.tokens);
+    allTokens.push(...result.tokens);
+  }
+  return {
+    byNamespace,
+    allTokens,
+    metadata: {
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      config: resolvedConfig,
+      tokenCount: allTokens.length,
+      namespaces: Array.from(byNamespace.keys())
+    }
+  };
+}
 
 // ../design-tokens/src/importers/adapter.ts
 var adapters = /* @__PURE__ */ new Map();
@@ -28701,6 +28785,21 @@ var PropFieldSchema = external_exports.discriminatedUnion("type", [
       requires: external_exports.object({ prop: external_exports.string() })
     }).optional()
   }),
+  external_exports.object({
+    type: external_exports.literal("boolean"),
+    default: external_exports.boolean().optional(),
+    required: external_exports.boolean().optional()
+  }),
+  external_exports.object({
+    type: external_exports.literal("string"),
+    default: external_exports.string().optional(),
+    required: external_exports.boolean().optional()
+  }),
+  external_exports.object({
+    type: external_exports.literal("number"),
+    default: external_exports.number().optional(),
+    required: external_exports.boolean().optional()
+  }),
   external_exports.object({
     // Matches #2072's PropNode 'grammar' arm exactly, so graph.ts's
     // describe(<id>.props.<name>.vocab) drill has real shape data.
@@ -29493,6 +29592,11 @@ function log(event) {
       console.log("  Skipped import. You can run `rafters import` later.");
       console.log("");
       break;
+    // Motion rebuild events
+    case "motion:override-dropped":
+      context.spinner?.stop();
+      console.warn(`  Warning: ${event.message}`);
+      break;
     default:
       if (context.spinner) {
         context.spinner.text = eventType;
@@ -29593,6 +29697,21 @@ async function installWithPackageManager(packageManager, dependencies, options)
 
 // src/utils/install-registry-deps.ts
 var RAFTERS_SCOPE_PREFIX = "@rafters/";
+var PLACEHOLDER_DEPENDENCY_NAMES = /* @__PURE__ */ new Set(["none", "n/a"]);
+function isPlaceholderDependencyName(name) {
+  const normalized = name.trim().toLowerCase();
+  return normalized === "" || PLACEHOLDER_DEPENDENCY_NAMES.has(normalized);
+}
+var PlaceholderDependencyError = class extends Error {
+  constructor(itemName, dependency) {
+    super(
+      `Registry item "${itemName}" declares dependency "${dependency}", which is not a real npm package name -- it looks like a placeholder left in the manifest. Refusing to install it.`
+    );
+    this.itemName = itemName;
+    this.dependency = dependency;
+    this.name = "PlaceholderDependencyError";
+  }
+};
 var REACT_RUNTIME_PACKAGES = /* @__PURE__ */ new Set(["react", "react-dom", "@types/react", "@types/react-dom"]);
 function parseDependency(dep) {
   const trimmed = dep.trim();
@@ -29639,6 +29758,16 @@ async function installRegistryDependencies(items, targetDir, options = {}) {
     devInstalled: [],
     failed: []
   };
+  for (const item of items) {
+    for (const file2 of item.files) {
+      for (const dep of file2.dependencies) {
+        const { name } = parseDependency(dep);
+        if (isPlaceholderDependencyName(name)) {
+          throw new PlaceholderDependencyError(item.name, dep);
+        }
+      }
+    }
+  }
   const allDeps = new Set(items.flatMap((item) => item.files.flatMap((file2) => file2.dependencies)));
   if (allDeps.size === 0) {
     return result;
@@ -29706,17 +29835,90 @@ async function installRegistryDependencies(items, targetDir, options = {}) {
   return result;
 }
 
+// src/utils/motion-rebuild.ts
+import { readdirSync as readdirSync2, readFileSync as readFileSync3 } from "fs";
+import { join as join5 } from "path";
+function hasStoredTokens(tokensDir) {
+  try {
+    return readdirSync2(tokensDir).some((entry) => entry.endsWith(".rafters.json"));
+  } catch {
+    return false;
+  }
+}
+var MOTION_CELL_PREFIX = "motion-cell-";
+var MotionCellSpecSchema = external_exports.object({
+  keyframe: external_exports.string(),
+  duration: external_exports.discriminatedUnion("kind", [
+    external_exports.object({ kind: external_exports.literal("tier"), tier: external_exports.string() }),
+    external_exports.object({ kind: external_exports.literal("period"), period: external_exports.string() })
+  ]),
+  curve: external_exports.string().optional()
+});
+function isCarryableMotionValue(name, value) {
+  if (!name.startsWith(MOTION_CELL_PREFIX)) return true;
+  if (typeof value !== "string") return false;
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch {
+    return true;
+  }
+  if (typeof parsed !== "object" || parsed === null) return true;
+  return MotionCellSpecSchema.safeParse(parsed).success;
+}
+var StoredMotionTokenSchema = external_exports.object({
+  name: external_exports.string(),
+  value: TokenSchema.shape.value,
+  userOverride: TokenSchema.shape.userOverride
+});
+function readStoredMotionOverrides(motionFile) {
+  const carried = /* @__PURE__ */ new Map();
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync3(motionFile, "utf8"));
+  } catch {
+    return carried;
+  }
+  const file2 = external_exports.object({ tokens: external_exports.array(external_exports.unknown()) }).safeParse(raw);
+  if (!file2.success) return carried;
+  for (const entry of file2.data.tokens) {
+    const parsed = StoredMotionTokenSchema.safeParse(entry);
+    if (!parsed.success) continue;
+    const { name, value, userOverride } = parsed.data;
+    if (!userOverride) continue;
+    carried.set(name, { value, userOverride });
+  }
+  return carried;
+}
+function regenerateMotionNamespace(tokensDir, plugins) {
+  const carried = readStoredMotionOverrides(join5(tokensDir, "motion.rafters.json"));
+  const tokens = generateNamespaces(["motion"]).allTokens.map((token) => {
+    const override = carried.get(token.name);
+    if (!override) return token;
+    if (!isCarryableMotionValue(token.name, override.value)) {
+      log({
+        event: "motion:override-dropped",
+        token: token.name,
+        message: `Stored override on "${token.name}" holds a value shape this version no longer emits; the token is rebuilt from the generator and the override is dropped.`
+      });
+      return token;
+    }
+    return { ...token, ...override };
+  });
+  saveRegistryToDir(tokensDir, new TokenRegistry(tokens, plugins));
+}
+
 // src/utils/paths.ts
 import { realpathSync as realpathSync2 } from "fs";
-import { isAbsolute as isAbsolute2, join as join5, relative, resolve as resolve2 } from "path";
+import { isAbsolute as isAbsolute2, join as join6, relative, resolve as resolve2 } from "path";
 function getRaftersPaths(projectRoot = process.cwd()) {
-  const root = join5(projectRoot, ".rafters");
+  const root = join6(projectRoot, ".rafters");
   return {
     root,
-    config: join5(root, "config.rafters.json"),
-    tokens: join5(root, "tokens"),
-    output: join5(root, "output"),
-    importPending: join5(root, "import-pending.json")
+    config: join6(root, "config.rafters.json"),
+    tokens: join6(root, "tokens"),
+    output: join6(root, "output"),
+    importPending: join6(root, "import-pending.json")
   };
 }
 var PathEntrySchema = external_exports.union([
@@ -29778,7 +29980,7 @@ function resolveReadSet(field, cwd, fallback) {
 }
 
 // src/utils/reconcile.ts
-import { readdirSync as readdirSync2 } from "fs";
+import { readdirSync as readdirSync3 } from "fs";
 var DISCOVERABLE_KINDS = ["components", "primitives", "composites"];
 var KIND_PATHS = {
   components: { field: "componentsPath", fallback: "components/ui" },
@@ -29810,7 +30012,7 @@ function readInstallRoots(cwd, config2) {
     const names = /* @__PURE__ */ new Set();
     for (const dir of resolveReadSet(pathField, cwd, fallback)) {
       try {
-        for (const entry of readdirSync2(dir)) names.add(entry);
+        for (const entry of readdirSync3(dir)) names.add(entry);
       } catch {
       }
     }
@@ -29837,14 +30039,11 @@ function migrateConfig(raw) {
 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;
+  if (!hasStoredTokens(paths.tokens)) return;
   try {
+    regenerateMotionNamespace(paths.tokens, REGISTRY_PLUGINS);
+    const registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS);
+    if (registry2.size() === 0) return;
     await regenerateOutputs(registry2, {
       outputDir: paths.output,
       exports: config2.exports,
@@ -29922,10 +30121,16 @@ function getComponentTarget(config2) {
   return resolveComponentTarget(config2);
 }
 var SHARED_EXTENSIONS = /* @__PURE__ */ new Set([".behavior.ts", ".classes.ts"]);
+var FRAMEWORK_EXTENSIONS = [".tsx", ".astro", ".vue", ".svelte", ".element.ts"];
 function isSharedFile(path) {
+  if (FRAMEWORK_EXTENSIONS.some((ext) => path.endsWith(ext))) return false;
   for (const ext of SHARED_EXTENSIONS) {
     if (path.endsWith(ext)) return true;
   }
+  if (path.startsWith("components/") && path.endsWith(".ts")) {
+    const afterComponents = path.slice("components/ui/".length);
+    if (afterComponents.includes("/")) return true;
+  }
   return false;
 }
 var REACT_FALLBACK_TARGETS = /* @__PURE__ */ new Set(["astro", "vue", "svelte"]);
@@ -30026,10 +30231,10 @@ function transformPath(registryPath, config2, cwd = process.cwd()) {
 function substrateProjectPath(registryPath, config2, cwd = process.cwd()) {
   const componentsResolved = rootFor(config2?.componentsPath, cwd, "components/ui");
   const sourceRoot = componentsResolved.replace(/\/?components\/ui$/, "");
-  return sourceRoot ? join6(sourceRoot, registryPath) : registryPath;
+  return sourceRoot ? join7(sourceRoot, registryPath) : registryPath;
 }
 function fileExists(cwd, relativePath) {
-  return existsSync3(join6(cwd, relativePath));
+  return existsSync3(join7(cwd, relativePath));
 }
 function transformFileContent(content, config2, fileType = "component", cwd = process.cwd(), opts = {}) {
   const { substrateKinds = [], installPath } = opts;
@@ -30041,28 +30246,64 @@ function transformFileContent(content, config2, fileType = "component", cwd = pr
   const aliasPrimitives = stripSourceRoot(primitivesPath);
   const toFlatPrimitive = (_match, subpath) => `from '@/${aliasPrimitives}/${basename(subpath)}'`;
   transformed = transformed.replace(
-    /from\s+['"]\.\.\/\.\.\/primitives\/([^'"]+)['"]/g,
+    /from\s+['"](?:\.\.\/)+primitives\/([^'"]+)['"]/g,
     toFlatPrimitive
   );
-  transformed = transformed.replace(/from\s+['"]\.\.\/primitives\/([^'"]+)['"]/g, toFlatPrimitive);
-  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'`);
+  const isSubsystemFile = fileType === "component" && installPath?.startsWith("components/") && installPath.slice("components/ui/".length).includes("/");
+  const SHARED_SUFFIX_BASES = [".behavior", ".classes", ".types", ".constants", ".styles"];
+  function extractComponentName(path) {
+    if (!path.startsWith("components/")) return null;
+    let base = basename(path).replace(/\.(tsx?|jsx?|astro|vue|svelte)$/, "");
+    for (const suffix of SHARED_SUFFIX_BASES) {
+      if (base.endsWith(suffix)) {
+        base = base.slice(0, -suffix.length);
+        break;
+      }
+    }
+    return base || null;
+  }
+  if (isSubsystemFile) {
+  } else if (fileType === "component" && installPath) {
+    const componentName = extractComponentName(installPath);
+    transformed = transformed.replace(
+      /from\s+['"]\.\/([^'"]+)['"]/g,
+      (_match, importPath) => {
+        if (SHARED_SUFFIX_BASES.some((s) => importPath.endsWith(s))) {
+          return `from '@/${aliasComponents}/${importPath}'`;
+        }
+        if (componentName) {
+          return `from '@/${aliasComponents}/${componentName}/${importPath}'`;
+        }
+        return `from '@/${aliasComponents}/${importPath}'`;
+      }
+    );
+  } else {
+    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"),
+      new RegExp(`from\\s+['"](?:\\.\\./)+?(${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'`
-  );
+  if (!isSubsystemFile) {
+    transformed = transformed.replace(
+      /from\s+['"]\.\.\/([^/'"]+)\/\1([^'"]*)['"]/g,
+      `from '@/${aliasComponents}/$1$2'`
+    );
+  }
+  if (!isSubsystemFile) {
+    transformed = transformed.replace(
+      /from\s+['"]\.\.\/([^'"]+)['"]/g,
+      `from '@/${aliasComponents}/$1'`
+    );
+  }
   return transformed;
 }
 async function installItem(cwd, item, options, config2, substrateKinds = []) {
@@ -30092,7 +30333,7 @@ async function installItem(cwd, item, options, config2, substrateKinds = []) {
   }
   for (const file2 of filesToInstall) {
     const projectPath2 = item.type === "substrate" ? substrateProjectPath(file2.path, config2, cwd) : transformPath(file2.path, config2, cwd);
-    const targetPath = join6(cwd, projectPath2);
+    const targetPath = join7(cwd, projectPath2);
     if (fileExists(cwd, projectPath2)) {
       if (!options.overwrite) {
         log({
@@ -30306,13 +30547,23 @@ async function add(componentArgs, options) {
       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 (err instanceof PlaceholderDependencyError) {
+      log({
+        event: "add:deps:install-failed",
+        message: err.message,
+        dependencies: [],
+        suggestion: "This is a registry defect, not a local problem -- do not install it manually."
+      });
+      process.exitCode = 1;
+    } else {
+      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({
@@ -30371,11 +30622,11 @@ async function add(componentArgs, options) {
 // src/commands/agents.ts
 import { existsSync as existsSync6 } from "fs";
 import { readFile as readFile6, writeFile as writeFile4 } from "fs/promises";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 
 // src/mcp/tools.ts
 import { readdir as readdir2, readFile as readFile5, writeFile as writeFile3 } from "fs/promises";
-import { isAbsolute as isAbsolute3, join as join10 } from "path";
+import { isAbsolute as isAbsolute3, join as join11 } from "path";
 
 // ../composites/src/built-in-rules/email.ts
 var email3 = external_exports.string().email();
@@ -30547,7 +30798,7 @@ var import_escape_html = __toESM(require_escape_html(), 1);
 
 // ../composites/src/discovery-node.ts
 import { readdir, readFile as readFile4 } from "fs/promises";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 var COMPOSITE_SUFFIX = ".composite.json";
 async function readDir(directory) {
   const entries = [];
@@ -30558,7 +30809,7 @@ async function readDir(directory) {
     return entries;
   }
   for (const dirent of dirents) {
-    const fullPath = join7(directory, dirent.name);
+    const fullPath = join8(directory, dirent.name);
     if (dirent.isDirectory()) {
       entries.push(...await readDir(fullPath));
       continue;
@@ -30585,16 +30836,16 @@ async function discoverFromDirs(...directories) {
 }
 
 // src/utils/workspaces.ts
-import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
-import { basename as basename2, dirname as dirname3, join as join9, resolve as resolve4 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
+import { basename as basename2, dirname as dirname3, join as join10, resolve as resolve4 } from "path";
 
 // src/utils/discover.ts
 import { existsSync as existsSync4 } from "fs";
-import { dirname as dirname2, join as join8, resolve as resolve3 } from "path";
+import { dirname as dirname2, join as join9, resolve as resolve3 } from "path";
 function discoverProjectRoot(startDir) {
   let current = resolve3(startDir);
   for (; ; ) {
-    const configPath2 = join8(current, ".rafters", "config.rafters.json");
+    const configPath2 = join9(current, ".rafters", "config.rafters.json");
     if (existsSync4(configPath2)) {
       return current;
     }
@@ -30611,16 +30862,16 @@ function findMonorepoRoot(startDir, boundary) {
   let current = resolve4(startDir);
   const stopAt = boundary ? resolve4(boundary) : null;
   for (; ; ) {
-    const pnpmWorkspace = join9(current, "pnpm-workspace.yaml");
+    const pnpmWorkspace = join10(current, "pnpm-workspace.yaml");
     if (existsSync5(pnpmWorkspace)) {
-      const patterns = parsePnpmWorkspaceYaml(readFileSync3(pnpmWorkspace, "utf-8"));
+      const patterns = parsePnpmWorkspaceYaml(readFileSync4(pnpmWorkspace, "utf-8"));
       if (patterns.length > 0) {
         return { root: current, patterns };
       }
     }
-    const pkgJson = join9(current, "package.json");
+    const pkgJson = join10(current, "package.json");
     if (existsSync5(pkgJson)) {
-      const patterns = parsePackageJsonWorkspaces(readFileSync3(pkgJson, "utf-8"));
+      const patterns = parsePackageJsonWorkspaces(readFileSync4(pkgJson, "utf-8"));
       if (patterns.length > 0) {
         return { root: current, patterns };
       }
@@ -30674,9 +30925,9 @@ function expandPattern(monorepoRoot, pattern) {
   const trimmed = pattern.replace(/\/+$/, "");
   if (trimmed.endsWith("/*")) {
     const parentRel = trimmed.slice(0, -2);
-    const parent = join9(monorepoRoot, parentRel);
+    const parent = join10(monorepoRoot, parentRel);
     if (!existsSync5(parent)) return [];
-    return readdirSync3(parent).map((entry) => join9(parent, entry)).filter((path) => {
+    return readdirSync4(parent).map((entry) => join10(parent, entry)).filter((path) => {
       try {
         return statSync2(path).isDirectory();
       } catch {
@@ -30684,7 +30935,7 @@ function expandPattern(monorepoRoot, pattern) {
       }
     });
   }
-  const literal2 = join9(monorepoRoot, trimmed);
+  const literal2 = join10(monorepoRoot, trimmed);
   if (existsSync5(literal2)) {
     try {
       if (statSync2(literal2).isDirectory()) return [literal2];
@@ -30708,13 +30959,13 @@ function discoverWorkspaces(startDir = process.cwd(), options = {}) {
     for (const dir of expandPattern(layout.root, pattern)) {
       if (seen.has(dir)) continue;
       seen.add(dir);
-      const config2 = join9(dir, ".rafters", "config.rafters.json");
+      const config2 = join10(dir, ".rafters", "config.rafters.json");
       if (existsSync5(config2)) {
         workspaces.push({ name: basename2(dir), root: dir });
       }
     }
   }
-  const rootConfig = join9(layout.root, ".rafters", "config.rafters.json");
+  const rootConfig = join10(layout.root, ".rafters", "config.rafters.json");
   if (existsSync5(rootConfig) && !seen.has(layout.root)) {
     workspaces.unshift({ name: basename2(layout.root), root: layout.root });
   }
@@ -31231,7 +31482,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "rafters_describe",
-    description: `Recursively introspect the component/composite intel graph. describe() returns the installed surface; describe(components)/describe(composites) list the kind roster; describe(button) returns a node -- intel plus type-marked, drillable children; describe(button.props.variant) drills into a prop -- an enum prop returns its literal union members; a grammar prop returns its composition rules, with the token vocabulary deliberately withheld. describe(button.*) expands all props inline in one call (no more drill-per-prop round trips); describe(button.props.color.?) probes safely (null on miss, not an error). A natural-language address (e.g. "what do I use when it needs to be above everything") routes through a separate intent door instead: deterministic keyword matching over a small, curated tag axis, returning a best-match node plus its near-miss counter-example. Below its match threshold it refuses rather than guessing, with a note pointing you at describe(components)/describe(composites) to browse; #2166 (open) is the follow-up that scores it against the intel this tool already owns. A part node carries parent, plus siblings when its parent has other parts; children are typed pointers you feed back in (the prop's own type for props, part for sub-components, edge for composesWith).`,
+    description: `Recursively introspect the component/composite intel graph. describe() returns the installed surface; describe(components)/describe(composites) list the kind roster; describe(button) returns a node -- intel plus type-marked, drillable children; describe(button.props.variant) drills into a prop -- an enum prop returns its literal union members; a boolean, string, or number prop returns its kind with any default and whether it is required, and no value list, because it has no finite one; a grammar prop returns its composition rules, with the token vocabulary deliberately withheld. describe(button.*) expands all props inline in one call (no more drill-per-prop round trips); describe(button.props.color.?) probes safely (null on miss, not an error). A natural-language address (e.g. "what do I use when it needs to be above everything") routes through a separate intent door instead: deterministic keyword matching over a small, curated tag axis, returning a best-match node plus its near-miss counter-example. Below its match threshold it refuses rather than guessing, with a note pointing you at describe(components)/describe(composites) to browse; #2166 (open) is the follow-up that scores it against the intel this tool already owns. A part node carries parent, plus siblings when its parent has other parts; children are typed pointers you feed back in (the prop's own type for props, part for sub-components, edge for composesWith).`,
     inputSchema: {
       type: "object",
       properties: {
@@ -31480,7 +31731,7 @@ var RaftersToolHandler = class {
   async ensureCompositesLoaded(workspace) {
     if (!this.builtInCompositesLoaded) {
       await this.loadCompositesFromDirs(
-        join10(process.cwd(), "node_modules/@rafters/composites/src/typography")
+        join11(process.cwd(), "node_modules/@rafters/composites/src/typography")
       );
       this.builtInCompositesLoaded = true;
     }
@@ -31599,7 +31850,7 @@ var RaftersToolHandler = class {
    */
   async scanInstalled(workspaceRoot, paths) {
     const idsUnder = async (field, fallback) => {
-      const roots = field ? resolveReadSet(field, workspaceRoot) : [join10(workspaceRoot, fallback)];
+      const roots = field ? resolveReadSet(field, workspaceRoot) : [join11(workspaceRoot, fallback)];
       const ids = /* @__PURE__ */ new Set();
       for (const root of roots) {
         let entries;
@@ -31758,7 +32009,7 @@ var RaftersToolHandler = class {
     const paths = getRaftersPaths(workspaceRoot);
     const config2 = await this.readConfig(workspaceRoot);
     if (!config2?.compositesPath) {
-      return [join10(paths.root, "composites")];
+      return [join11(paths.root, "composites")];
     }
     return resolveReadSet(config2.compositesPath, workspaceRoot);
   }
@@ -31973,7 +32224,7 @@ async function agents() {
       `No rafters project found: ${paths.config} is missing. Run \`rafters init\` first.`
     );
   }
-  const agentsPath = join11(cwd, "AGENTS.md");
+  const agentsPath = join12(cwd, "AGENTS.md");
   const existing = existsSync6(agentsPath) ? await readFile6(agentsPath, "utf-8") : null;
   const merged = mergeAgentContract(existing, generateAgentContract());
   await writeFile4(agentsPath, merged);
@@ -31983,7 +32234,7 @@ async function agents() {
 import { existsSync as existsSync7 } from "fs";
 import { copyFile, mkdir as mkdir3, readFile as readFile7, rm, writeFile as writeFile5 } from "fs/promises";
 import { createRequire } from "module";
-import { join as join12, relative as relative2 } from "path";
+import { join as join13, relative as relative2 } from "path";
 import { checkbox, confirm, select } from "@inquirer/prompts";
 var REGISTRY_PLUGINS2 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
 async function backupCss(cssPath) {
@@ -32067,7 +32318,7 @@ function cleanSourceCssBlocks(content) {
 }
 async function stripImportedDeclarations(cwd, cssPath, importedNames) {
   if (importedNames.length === 0) return;
-  const fullPath = join12(cwd, cssPath);
+  const fullPath = join13(cwd, cssPath);
   const content = await readFile7(fullPath, "utf-8");
   const pattern = new RegExp(importedNames.map((n2) => `^\\s*--${n2}[^;]*;\\s*$`).join("|"), "gm");
   const cleaned = cleanSourceCssBlocks(content.replace(pattern, ""));
@@ -32075,10 +32326,10 @@ async function stripImportedDeclarations(cwd, cssPath, importedNames) {
   await writeFile5(fullPath, collapsed);
 }
 async function updateMainCss(cwd, cssPath, themePath) {
-  const fullCssPath = join12(cwd, cssPath);
+  const fullCssPath = join13(cwd, cssPath);
   const cssContent = await readFile7(fullCssPath, "utf-8");
-  const cssDir = join12(cwd, cssPath, "..");
-  const themeFullPath = join12(cwd, themePath);
+  const cssDir = join13(cwd, cssPath, "..");
+  const themeFullPath = join13(cwd, themePath);
   const relativeThemePath = relative2(cssDir, themeFullPath);
   if (cssContent.includes(".rafters/output/rafters.css")) {
     log({ event: "init:css_already_imported", cssPath });
@@ -32107,7 +32358,7 @@ function isInteractive() {
 }
 function resolveSourceCssPath(cwd, framework, detectedFramework, projectCssPath, shadcnCssPath, emit) {
   if (shadcnCssPath) {
-    if (existsSync7(join12(cwd, shadcnCssPath))) return shadcnCssPath;
+    if (existsSync7(join13(cwd, shadcnCssPath))) return shadcnCssPath;
     const fallback = framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
     emit({
       event: "init:shadcn_css_missing",
@@ -32242,8 +32493,11 @@ async function regenerateFromExisting(cwd, paths, source, isAgentMode2, framewor
     existingConfig.compositesPath = frameworkPaths.composites;
     existingConfig.rulesPath = frameworkPaths.rules;
   }
-  await rm(join12(paths.tokens, "elevation.rafters.json"), { force: true });
-  await rm(join12(paths.tokens, "fill.rafters.json"), { force: true });
+  await rm(join13(paths.tokens, "elevation.rafters.json"), { force: true });
+  await rm(join13(paths.tokens, "fill.rafters.json"), { force: true });
+  if (hasStoredTokens(paths.tokens)) {
+    regenerateMotionNamespace(paths.tokens, REGISTRY_PLUGINS2);
+  }
   const registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2);
   if (registry2.size() === 0) {
     throw new Error("No tokens found. Cannot regenerate without existing tokens.");
@@ -32338,7 +32592,7 @@ async function resetToDefaults(cwd, paths, source, isAgentMode2, framework) {
     };
     await mkdir3(paths.output, { recursive: true });
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const backupPath = join12(paths.output, `reset-${timestamp}.json`);
+    const backupPath = join13(paths.output, `reset-${timestamp}.json`);
     await writeFile5(backupPath, JSON.stringify(backup, null, 2));
     log({
       event: "init:reset_backup",
@@ -32476,7 +32730,7 @@ async function init(options) {
   );
   if (sourceCssPathForBase !== null) {
     try {
-      const cssForBase = await readFile7(join12(cwd, sourceCssPathForBase), "utf-8");
+      const cssForBase = await readFile7(join13(cwd, sourceCssPathForBase), "utf-8");
       const baseSlots = [
         {
           detect: () => adapter.detectSpacing(cssForBase).base,
@@ -32599,7 +32853,7 @@ async function init(options) {
   if (detectedCssPath) {
     let sourceCss = null;
     try {
-      sourceCss = await readFile7(join12(cwd, detectedCssPath), "utf-8");
+      sourceCss = await readFile7(join13(cwd, detectedCssPath), "utf-8");
     } catch (err) {
       if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
     }
@@ -32866,7 +33120,7 @@ async function init(options) {
 
 // src/commands/mcp.ts
 import { existsSync as existsSync8 } from "fs";
-import { basename as basename3, join as join13, resolve as resolve5 } from "path";
+import { basename as basename3, join as join14, resolve as resolve5 } from "path";
 
 // src/mcp/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -32919,7 +33173,7 @@ async function mcp(options) {
   let defaultWorkspace;
   if (options.projectRoot) {
     const explicit = resolve5(options.projectRoot);
-    const configPath2 = join13(explicit, ".rafters", "config.rafters.json");
+    const configPath2 = join14(explicit, ".rafters", "config.rafters.json");
     if (!existsSync8(configPath2)) {
       process.stderr.write(
         `--project-root ${explicit} does not contain .rafters/config.rafters.json
@@ -32945,7 +33199,7 @@ import { resolve as resolve6 } from "path";
 
 // ../studio/src/api/vite-plugin.ts
 import { readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
-import { isAbsolute as isAbsolute4, join as join14 } from "path";
+import { isAbsolute as isAbsolute4, join as join15 } from "path";
 var REGISTRY_PLUGINS3 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
 var STUDIO_REASON_DEFAULT = "studio interactive edit";
 var TokenResponseSchema = external_exports.object({
@@ -32971,8 +33225,8 @@ var ColorBuildOptionsSchema = external_exports.object({
   states: external_exports.record(external_exports.string(), external_exports.string()).optional()
 });
 var projectPath = process.env.RAFTERS_PROJECT_PATH || process.cwd();
-var outputDir = join14(projectPath, ".rafters", "output");
-var configPath = join14(projectPath, ".rafters", "config.rafters.json");
+var outputDir = join15(projectPath, ".rafters", "output");
+var configPath = join15(projectPath, ".rafters", "config.rafters.json");
 var FontsConfigSchema = external_exports.object({
   path: external_exports.union([external_exports.string(), external_exports.null()]).optional(),
   imports: external_exports.array(external_exports.string()).optional()
@@ -33399,7 +33653,7 @@ function studioApiPlugin() {
   return {
     name: "rafters-studio-api",
     async configureServer(server) {
-      const tokensDir = join14(projectPath, ".rafters", "tokens");
+      const tokensDir = join15(projectPath, ".rafters", "tokens");
       try {
         registry2 = loadRegistryFromDir(tokensDir, REGISTRY_PLUGINS3);
         initialized = true;
@@ -33462,11 +33716,11 @@ function studioApiPlugin() {
           const classDirs = watchConfig ? resolveContentSources(projectPath, watchConfig) : [];
           const newDirs = classDirs.filter((d2) => !trackedClassDirs.has(d2));
           if (newDirs.length > 0) {
-            server.watcher.add(newDirs.map((dir) => join14(dir, "**/*.classes.ts")));
+            server.watcher.add(newDirs.map((dir) => join15(dir, "**/*.classes.ts")));
             for (const d2 of newDirs) trackedClassDirs.add(d2);
           }
         };
-        server.watcher.add([join14(tokensDir, "*.rafters.json"), configPath]);
+        server.watcher.add([join15(tokensDir, "*.rafters.json"), configPath]);
         await syncWatchTargets();
         let debounce = null;
         const onChange = (changed) => {

package/dist/registry/types.d.ts

@@ -96,6 +96,18 @@ declare const PropFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             prop: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"boolean">;
+    default: z.ZodOptional<z.ZodBoolean>;
+    required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"string">;
+    default: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    default: z.ZodOptional<z.ZodNumber>;
+    required: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"grammar">;
     grammar: z.ZodArray<z.ZodString>;
@@ -126,6 +138,18 @@ declare const FacetSchema: z.ZodObject<{
                 prop: z.ZodString;
             }, z.core.$strip>;
         }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"boolean">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"string">;
+        default: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        default: z.ZodOptional<z.ZodNumber>;
+        required: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"grammar">;
         grammar: z.ZodArray<z.ZodString>;
@@ -195,6 +219,18 @@ declare const RegistryItemSchema: z.ZodObject<{
                     prop: z.ZodString;
                 }, z.core.$strip>;
             }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"boolean">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"string">;
+            default: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            default: z.ZodOptional<z.ZodNumber>;
+            required: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"grammar">;
             grammar: z.ZodArray<z.ZodString>;

package/dist/registry/types.js

@@ -33,6 +33,21 @@ var PropFieldSchema = z.discriminatedUnion("type", [
       requires: z.object({ prop: z.string() })
     }).optional()
   }),
+  z.object({
+    type: z.literal("boolean"),
+    default: z.boolean().optional(),
+    required: z.boolean().optional()
+  }),
+  z.object({
+    type: z.literal("string"),
+    default: z.string().optional(),
+    required: z.boolean().optional()
+  }),
+  z.object({
+    type: z.literal("number"),
+    default: z.number().optional(),
+    required: z.boolean().optional()
+  }),
   z.object({
     // Matches #2072's PropNode 'grammar' arm exactly, so graph.ts's
     // describe(<id>.props.<name>.vocab) drill has real shape data.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Design Intelligence CLI. Scaffold tokens, import existing shadcn/Tailwind v4 sources, add components, and serve an MCP server so AI agents read decisions instead of guessing.",
   "homepage": "https://rafters.studio",
   "license": "MIT",