rafters 0.0.56 → 0.0.58

package/README.md

@@ -4,6 +4,10 @@ Design Intelligence CLI. Encodes a designer's judgment into queryable data so AI
 
 → [rafters.studio](https://rafters.studio)
 
+**60+ components across React, Astro, and Web Components.** Triple-target parity from one design system — the same Button, Card, Dialog, Combobox, Editor, etc. as a React component, an Astro component, AND a Web Component element class. Component code is installed into your project via `rafters add` (shadcn-style copy), not imported as a dependency, so you own and can fork what ships.
+
+**Composite manifests sit above components.** A composite is a designer-authored JSON manifest that bundles components into reusable patterns (login-form, copy-button, heading, paragraph) with designer intent baked in: `solves`, `appliesWhen`, do/never rules, cognitive load rating, I/O contracts, and a typed block tree. Agents query the composite registry via MCP and assemble pre-made decisions instead of inventing new ones.
+
 ## Quick Start
 
 ```bash
@@ -130,13 +134,12 @@ Full intelligence for a specific component: cognitive load, accessibility level,
 
 ## Architecture
 
-Three layers:
-
-- **What (Components)** — React components with embedded intelligence metadata
-- **Where (Tokens)** — token dependency graph with human override tracking
-- **Why (Decisions)** — composite manifests, do/never patterns, cognitive load scores, trust-building patterns
+Four layers, stacked:
 
-The token system uses OKLCH color space, modular scales based on musical ratios, and a dependency engine that derives related values from primitive bases. Override a base — `spacing-base`, `radius-base`, `font-size-base` — and dependents recompute. Override a leaf (`primary` color, `spacing-4`) and the override anchors the subtree against future upstream changes.
+- **Tokens** — primitive design values (color OKLCH, spacing scale, radius, typography, motion, focus, shadow, depth, elevation, breakpoints). 13 namespaces; dependency graph with human override tracking. Override a base (`spacing-base`, `radius-base`, `font-size-base`) and dependents recompute. Override a leaf and the override anchors the subtree.
+- **Primitives** — 62 framework-agnostic building blocks (clipboard, focus-trap, portal, roving-focus, selection, serializer, slot, token-sheet, typeahead, etc.). Headless behaviors components compose against.
+- **Components** — 60+ React + 71 Astro + 32 Web Component element classes. Triple-target parity. Each component carries embedded intelligence metadata: cognitive load rating, accessibility level, do/never, variant semantics, attention economics. Installed into your project via `rafters add` — you own the code.
+- **Composites** — designer-authored JSON manifests that bundle components into reusable patterns (login-form, copy-button, heading, paragraph, etc.). Each manifest carries `solves`, `appliesWhen`, `usagePatterns` (do/never), `cognitiveLoad`, I/O contracts, and a typed block tree. The composite owns the variant/size decisions — agents render blocks verbatim instead of choosing aesthetics.
 
 When a designer overrides a computed value, the system records the reason. Agents read the why before they read the what.
 

package/dist/index.js

@@ -12565,6 +12565,17 @@ var RegistryFileSchema = external_exports.object({
   // e.g., ["vitest"] - from @devDependencies JSDoc
 });
 var RegistryItemTypeSchema = external_exports.enum(["ui", "primitive", "composite"]);
+var RegistryItemIntelligenceSchema = external_exports.object({
+  cognitiveLoad: external_exports.number().optional(),
+  attentionEconomics: external_exports.string().optional(),
+  trustBuilding: external_exports.string().optional(),
+  accessibility: external_exports.string().optional(),
+  semanticMeaning: external_exports.string().optional(),
+  usagePatterns: external_exports.object({
+    dos: external_exports.array(external_exports.string()).default([]),
+    nevers: external_exports.array(external_exports.string()).default([])
+  }).optional()
+});
 var RegistryItemSchema = external_exports.object({
   name: external_exports.string(),
   type: RegistryItemTypeSchema,
@@ -12572,7 +12583,8 @@ var RegistryItemSchema = external_exports.object({
   primitives: external_exports.array(external_exports.string()),
   files: external_exports.array(RegistryFileSchema),
   rules: external_exports.array(external_exports.string()).default([]),
-  composites: external_exports.array(external_exports.string()).default([])
+  composites: external_exports.array(external_exports.string()).default([]),
+  intelligence: RegistryItemIntelligenceSchema.optional()
 });
 var RegistryIndexSchema = external_exports.object({
   name: external_exports.string(),
@@ -28494,7 +28506,6 @@ function firstFamilyFromStack(value) {
   for (const raw of parts) {
     const stripped = stripQuotes(raw.trim());
     if (stripped === "" || GENERIC_KEYWORDS.has(stripped.toLowerCase())) continue;
-    if (stripped.startsWith("var(") || stripped.includes("var(--")) continue;
     return stripped;
   }
   return null;
@@ -30441,7 +30452,16 @@ var RaftersToolHandler = class {
                 type: item.type,
                 description: item.description,
                 primitives: item.primitives,
-                rules: item.rules
+                rules: item.rules,
+                composites: item.composites,
+                files: item.files,
+                // The intelligence field carries the WHY of the component:
+                // cognitive load, accessibility, do/never, semantic meaning.
+                // Extracted from JSDoc by the registry generator and present
+                // on every component JSON. Previously stripped by the schema
+                // (not declared) and not referenced by the handler -- the
+                // tool's whole reason for existing went missing somewhere.
+                intelligence: item.intelligence
               },
               null,
               2

package/dist/registry/types.d.ts

@@ -27,6 +27,27 @@ declare const RegistryItemTypeSchema: z.ZodEnum<{
     composite: "composite";
 }>;
 type RegistryItemType = z.infer<typeof RegistryItemTypeSchema>;
+/**
+ * Design intelligence carried per-component. The registry generator
+ * extracts these from JSDoc tags on the component source (see
+ * `@cognitive-load`, `@attention-economics`, `@trust-building`,
+ * `@accessibility`, `@semantic-meaning`, `@usage-patterns` in e.g.
+ * packages/ui/src/components/ui/button.tsx). Surfacing this is the
+ * whole point of rafters -- agents read the encoded judgment instead
+ * of guessing at the design surface.
+ */
+declare const RegistryItemIntelligenceSchema: z.ZodObject<{
+    cognitiveLoad: z.ZodOptional<z.ZodNumber>;
+    attentionEconomics: z.ZodOptional<z.ZodString>;
+    trustBuilding: z.ZodOptional<z.ZodString>;
+    accessibility: z.ZodOptional<z.ZodString>;
+    semanticMeaning: z.ZodOptional<z.ZodString>;
+    usagePatterns: z.ZodOptional<z.ZodObject<{
+        dos: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        nevers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type RegistryItemIntelligence = z.infer<typeof RegistryItemIntelligenceSchema>;
 /**
  * A component or primitive in the registry
  */
@@ -47,6 +68,17 @@ declare const RegistryItemSchema: z.ZodObject<{
     }, z.core.$strip>>;
     rules: z.ZodDefault<z.ZodArray<z.ZodString>>;
     composites: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    intelligence: z.ZodOptional<z.ZodObject<{
+        cognitiveLoad: z.ZodOptional<z.ZodNumber>;
+        attentionEconomics: z.ZodOptional<z.ZodString>;
+        trustBuilding: z.ZodOptional<z.ZodString>;
+        accessibility: z.ZodOptional<z.ZodString>;
+        semanticMeaning: z.ZodOptional<z.ZodString>;
+        usagePatterns: z.ZodOptional<z.ZodObject<{
+            dos: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            nevers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type RegistryItem = z.infer<typeof RegistryItemSchema>;
 /**
@@ -62,4 +94,4 @@ declare const RegistryIndexSchema: z.ZodObject<{
 }, z.core.$strip>;
 type RegistryIndex = z.infer<typeof RegistryIndexSchema>;
 
-export { type RegistryFile, RegistryFileSchema, type RegistryIndex, RegistryIndexSchema, type RegistryItem, RegistryItemSchema, type RegistryItemType, RegistryItemTypeSchema };
+export { type RegistryFile, RegistryFileSchema, type RegistryIndex, RegistryIndexSchema, type RegistryItem, type RegistryItemIntelligence, RegistryItemIntelligenceSchema, RegistryItemSchema, type RegistryItemType, RegistryItemTypeSchema };

package/dist/registry/types.js

@@ -9,6 +9,17 @@ var RegistryFileSchema = z.object({
   // e.g., ["vitest"] - from @devDependencies JSDoc
 });
 var RegistryItemTypeSchema = z.enum(["ui", "primitive", "composite"]);
+var RegistryItemIntelligenceSchema = z.object({
+  cognitiveLoad: z.number().optional(),
+  attentionEconomics: z.string().optional(),
+  trustBuilding: z.string().optional(),
+  accessibility: z.string().optional(),
+  semanticMeaning: z.string().optional(),
+  usagePatterns: z.object({
+    dos: z.array(z.string()).default([]),
+    nevers: z.array(z.string()).default([])
+  }).optional()
+});
 var RegistryItemSchema = z.object({
   name: z.string(),
   type: RegistryItemTypeSchema,
@@ -16,7 +27,8 @@ var RegistryItemSchema = z.object({
   primitives: z.array(z.string()),
   files: z.array(RegistryFileSchema),
   rules: z.array(z.string()).default([]),
-  composites: z.array(z.string()).default([])
+  composites: z.array(z.string()).default([]),
+  intelligence: RegistryItemIntelligenceSchema.optional()
 });
 var RegistryIndexSchema = z.object({
   name: z.string(),
@@ -29,6 +41,7 @@ var RegistryIndexSchema = z.object({
 export {
   RegistryFileSchema,
   RegistryIndexSchema,
+  RegistryItemIntelligenceSchema,
   RegistryItemSchema,
   RegistryItemTypeSchema
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.56",
+  "version": "0.0.58",
   "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",