rafters 0.3.0 → 0.3.1

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 = {
@@ -21054,8 +21054,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 +21065,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 +21076,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 +21252,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 +21264,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 +21274,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);
@@ -27105,6 +27105,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 +28727,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 +29534,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;
@@ -29706,17 +29752,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 +29897,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 +29929,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 +29956,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 +30038,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 +30148,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 +30163,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 +30250,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({
@@ -30371,11 +30529,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 +30705,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 +30716,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 +30743,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 +30769,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 +30832,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 +30842,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 +30866,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 +31389,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 +31638,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 +31757,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 +31916,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 +32131,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 +32141,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 +32225,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 +32233,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 +32265,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 +32400,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 +32499,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 +32637,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 +32760,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 +33027,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 +33080,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 +33106,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 +33132,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 +33560,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 +33623,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.3.1",
   "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",