@vadimcomanescu/nadicode-design-system 2.0.6 → 2.0.8

package/contracts/block-props-schemas.json

@@ -0,0 +1,2186 @@
+{
+  "schemaVersion": "1.0.0",
+  "blocks": {
+    "AccountLockedBlock": {
+      "canonicalExport": "AccountLockedBlock",
+      "subpath": "./account-locked-block",
+      "sourceFile": "src/components/blocks/AccountLockedBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "Account locked notification",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "reason",
+          "unlockMinutes",
+          "onContactSupport",
+          "onBackToLogin",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "reason": {
+            "required": false,
+            "type": "\"too_many_attempts\" | \"suspicious_activity\" | \"admin\""
+          },
+          "unlockMinutes": {
+            "required": false,
+            "type": "number"
+          },
+          "onContactSupport": {
+            "required": false,
+            "type": "() => void"
+          },
+          "onBackToLogin": {
+            "required": false,
+            "type": "() => void"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ActivityFeedBlock": {
+      "canonicalExport": "ActivityFeedBlock",
+      "subpath": "./activity-feed-block",
+      "sourceFile": "src/components/blocks/ActivityFeedBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Activity/event timeline",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "activities",
+          "title"
+        ],
+        "properties": {
+          "activities": {
+            "required": false,
+            "type": "Activity[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "AgentConversationBlock": {
+      "canonicalExport": "AgentConversationBlock",
+      "subpath": "./agent-conversation-block",
+      "sourceFile": "src/components/blocks/AgentConversationBlock.tsx",
+      "category": "Agentic",
+      "tier": "stable",
+      "description": "Agent conversation UI (messages, tool calls, thinking)",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [
+          "messages"
+        ],
+        "optional": [],
+        "properties": {
+          "messages": {
+            "required": true,
+            "type": "ConversationMessage[]"
+          }
+        }
+      }
+    },
+    "AgentProfileGridBlock": {
+      "canonicalExport": "AgentProfileGridBlock",
+      "subpath": "./agent-profile-grid-block",
+      "sourceFile": "src/components/blocks/AgentProfileGridBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Agent/worker profile card grid (\"Meet your AI team\")",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "agents",
+          "columns"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "agents": {
+            "required": false,
+            "type": "AgentProfile[]"
+          },
+          "columns": {
+            "required": false,
+            "type": "2 | 3 | 4"
+          }
+        }
+      }
+    },
+    "AgentRunOverviewBlock": {
+      "canonicalExport": "AgentRunOverviewBlock",
+      "subpath": "./agent-run-overview-block",
+      "sourceFile": "src/components/blocks/AgentRunOverviewBlock.tsx",
+      "category": "Agentic",
+      "tier": "stable",
+      "description": "Agent run summary with status, duration, and output",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "teamTitle",
+          "metricsTitle",
+          "contextTitle",
+          "workflow",
+          "agents",
+          "metrics",
+          "context"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "teamTitle": {
+            "required": false,
+            "type": "string"
+          },
+          "metricsTitle": {
+            "required": false,
+            "type": "string"
+          },
+          "contextTitle": {
+            "required": false,
+            "type": "string"
+          },
+          "workflow": {
+            "required": false,
+            "type": "AgentRunOverviewWorkflow"
+          },
+          "agents": {
+            "required": false,
+            "type": "AgentTeamPanelProps['agents']"
+          },
+          "metrics": {
+            "required": false,
+            "type": "Metric[]"
+          },
+          "context": {
+            "required": false,
+            "type": "AgentRunOverviewContext"
+          }
+        }
+      }
+    },
+    "AgentWorkbenchBlock": {
+      "canonicalExport": "AgentWorkbenchBlock",
+      "subpath": "./agent-workbench-block",
+      "sourceFile": "src/components/blocks/AgentWorkbenchBlock.tsx",
+      "category": "Agentic",
+      "tier": "stable",
+      "description": "Agent workbench layout with tool panels and conversation",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "threadTitle",
+          "workTitle",
+          "defaultWorkTab",
+          "messages",
+          "artifacts",
+          "diffs",
+          "logs",
+          "composer"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "threadTitle": {
+            "required": false,
+            "type": "string"
+          },
+          "workTitle": {
+            "required": false,
+            "type": "string"
+          },
+          "defaultWorkTab": {
+            "required": false,
+            "type": "'artifacts' | 'diffs' | 'logs'"
+          },
+          "messages": {
+            "required": false,
+            "type": "AgentWorkbenchMessage[]"
+          },
+          "artifacts": {
+            "required": false,
+            "type": "AgentWorkbenchArtifact[]"
+          },
+          "diffs": {
+            "required": false,
+            "type": "AgentWorkbenchDiff[]"
+          },
+          "logs": {
+            "required": false,
+            "type": "TerminalLine[]"
+          },
+          "composer": {
+            "required": false,
+            "type": "AgentWorkbenchComposer"
+          }
+        }
+      }
+    },
+    "AudioVisualizerBlock": {
+      "canonicalExport": "AudioVisualizerBlock",
+      "subpath": "./audio-visualizer-block",
+      "sourceFile": "src/components/blocks/AudioVisualizerBlock.tsx",
+      "category": "Content & Media",
+      "tier": "stable",
+      "description": "Audio visualization display",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "bars",
+          "isPlaying"
+        ],
+        "properties": {
+          "bars": {
+            "required": false,
+            "type": "number"
+          },
+          "isPlaying": {
+            "required": false,
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "AuthLayout": {
+      "canonicalExport": "AuthLayout",
+      "subpath": "./auth-layout",
+      "sourceFile": "src/components/blocks/AuthLayout.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "Split-screen auth layout wrapper",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "mode",
+          "action",
+          "error",
+          "googleAction",
+          "labels"
+        ],
+        "properties": {
+          "mode": {
+            "required": false,
+            "type": "\"login\" | \"signup\""
+          },
+          "action": {
+            "required": false,
+            "type": "(formData: FormData) => void | Promise<void>"
+          },
+          "error": {
+            "required": false,
+            "type": "string | null"
+          },
+          "googleAction": {
+            "required": false,
+            "type": "(formData: FormData) => void | Promise<void>"
+          },
+          "labels": {
+            "required": false,
+            "type": "Partial<typeof defaultLabels>"
+          }
+        }
+      }
+    },
+    "AuthSuccessBlock": {
+      "canonicalExport": "AuthSuccessBlock",
+      "subpath": "./auth-success-block",
+      "sourceFile": "src/components/blocks/AuthSuccessBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "Generic auth success state",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [
+          "icon",
+          "title",
+          "description"
+        ],
+        "optional": [
+          "buttonText",
+          "onContinue",
+          "autoRedirectSeconds"
+        ],
+        "properties": {
+          "icon": {
+            "required": true,
+            "type": "React.ReactNode"
+          },
+          "title": {
+            "required": true,
+            "type": "string"
+          },
+          "description": {
+            "required": true,
+            "type": "string"
+          },
+          "buttonText": {
+            "required": false,
+            "type": "string"
+          },
+          "onContinue": {
+            "required": false,
+            "type": "() => void"
+          },
+          "autoRedirectSeconds": {
+            "required": false,
+            "type": "number"
+          }
+        }
+      }
+    },
+    "BannerBlock": {
+      "canonicalExport": "BannerBlock",
+      "subpath": "./banner-block",
+      "sourceFile": "src/components/blocks/BannerBlock.tsx",
+      "category": "Navigation",
+      "tier": "stable",
+      "description": "Top-of-page promotional banner",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "variant",
+          "dismissible",
+          "onDismiss"
+        ],
+        "properties": {
+          "variant": {
+            "required": false,
+            "type": "\"info\" | \"warning\" | \"accent\""
+          },
+          "dismissible": {
+            "required": false,
+            "type": "boolean"
+          },
+          "onDismiss": {
+            "required": false,
+            "type": "() => void"
+          }
+        }
+      }
+    },
+    "BarChartBlock": {
+      "canonicalExport": "BarChartBlock",
+      "subpath": "./bar-chart-block",
+      "sourceFile": "src/components/blocks/BarChartBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Pre-configured bar chart",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "data",
+          "config",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "data": {
+            "required": false,
+            "type": "BarChartDataItem[]"
+          },
+          "config": {
+            "required": false,
+            "type": "ChartConfig"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "CallToActionBlock": {
+      "canonicalExport": "CallToActionBlock",
+      "subpath": "./call-to-action-block",
+      "sourceFile": "src/components/blocks/CallToActionBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Call-to-action section",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "primaryAction",
+          "secondaryAction"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "primaryAction": {
+            "required": false,
+            "type": "CallToActionAction"
+          },
+          "secondaryAction": {
+            "required": false,
+            "type": "CallToActionAction"
+          }
+        }
+      }
+    },
+    "ChangelogBlock": {
+      "canonicalExport": "ChangelogBlock",
+      "subpath": "./changelog-block",
+      "sourceFile": "src/components/blocks/ChangelogBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Version changelog display",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "entries",
+          "title"
+        ],
+        "properties": {
+          "entries": {
+            "required": false,
+            "type": "ChangelogEntry[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ChartBlock": {
+      "canonicalExport": "ChartBlock",
+      "subpath": "./chart-block",
+      "sourceFile": "src/components/blocks/ChartBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Single chart container",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "data",
+          "config",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "data": {
+            "required": false,
+            "type": "ChartBlockDataItem[]"
+          },
+          "config": {
+            "required": false,
+            "type": "ChartConfig"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ChartCollectionBlock": {
+      "canonicalExport": "ChartCollectionBlock",
+      "subpath": "./chart-collection-block",
+      "sourceFile": "src/components/blocks/ChartCollectionBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Multiple chart grid",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": true,
+        "required": [],
+        "optional": [],
+        "properties": {}
+      }
+    },
+    "ChatLayout": {
+      "canonicalExport": "ChatLayout",
+      "subpath": "./chat-layout",
+      "sourceFile": "src/components/blocks/ChatLayout.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Chat application layout",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "initialMessages",
+          "assistantName",
+          "assistantStatus",
+          "placeholder"
+        ],
+        "properties": {
+          "initialMessages": {
+            "required": false,
+            "type": "Message[]"
+          },
+          "assistantName": {
+            "required": false,
+            "type": "string"
+          },
+          "assistantStatus": {
+            "required": false,
+            "type": "string"
+          },
+          "placeholder": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "CodeBlock": {
+      "canonicalExport": "CodeBlock",
+      "subpath": "./code-block",
+      "sourceFile": "src/components/blocks/CodeBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Syntax-highlighted code display",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [
+          "code"
+        ],
+        "optional": [
+          "language",
+          "filename"
+        ],
+        "properties": {
+          "code": {
+            "required": true,
+            "type": "string"
+          },
+          "language": {
+            "required": false,
+            "type": "string"
+          },
+          "filename": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ComparisonBlock": {
+      "canonicalExport": "ComparisonBlock",
+      "subpath": "./comparison-block",
+      "sourceFile": "src/components/blocks/ComparisonBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Side-by-side feature comparison",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "plans",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "plans": {
+            "required": false,
+            "type": "ComparisonPlan[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ContactBlock": {
+      "canonicalExport": "ContactBlock",
+      "subpath": "./contact-block",
+      "sourceFile": "src/components/blocks/ContactBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Contact form",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "onSubmit",
+          "title",
+          "description",
+          "namePlaceholder",
+          "emailPlaceholder",
+          "messagePlaceholder",
+          "successTitle",
+          "submitLabel"
+        ],
+        "properties": {
+          "onSubmit": {
+            "required": false,
+            "type": "(data: { name: string; email: string; message: string }) => void"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "namePlaceholder": {
+            "required": false,
+            "type": "string"
+          },
+          "emailPlaceholder": {
+            "required": false,
+            "type": "string"
+          },
+          "messagePlaceholder": {
+            "required": false,
+            "type": "string"
+          },
+          "successTitle": {
+            "required": false,
+            "type": "string"
+          },
+          "submitLabel": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "CreateBlock": {
+      "canonicalExport": "CreateBlock",
+      "subpath": "./create-block",
+      "sourceFile": "src/components/blocks/CreateBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Entity creation form",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "submitLabel",
+          "onSubmit"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "submitLabel": {
+            "required": false,
+            "type": "string"
+          },
+          "onSubmit": {
+            "required": false,
+            "type": "(data: ProfileFormValues) => void"
+          }
+        }
+      }
+    },
+    "DataGridBlock": {
+      "canonicalExport": "DataGridBlock",
+      "subpath": "./data-grid-block",
+      "sourceFile": "src/components/blocks/DataGridBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Data grid/table block",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "data",
+          "columns",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "data": {
+            "required": false,
+            "type": "Payment[]"
+          },
+          "columns": {
+            "required": false,
+            "type": "ColumnDef<Payment>[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "DirectoryBlock": {
+      "canonicalExport": "DirectoryBlock",
+      "subpath": "./directory-block",
+      "sourceFile": "src/components/blocks/DirectoryBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "User/item directory with search",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "navItems",
+          "projects"
+        ],
+        "properties": {
+          "navItems": {
+            "required": false,
+            "type": "NavItem[]"
+          },
+          "projects": {
+            "required": false,
+            "type": "ProjectItem[]"
+          }
+        }
+      }
+    },
+    "FAQBlock": {
+      "canonicalExport": "FAQBlock",
+      "subpath": "./faq-block",
+      "sourceFile": "src/components/blocks/FAQBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "FAQ accordion",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "items",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "items": {
+            "required": false,
+            "type": "FAQItem[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "FeatureBlock": {
+      "canonicalExport": "FeatureBlock",
+      "subpath": "./feature-block",
+      "sourceFile": "src/components/blocks/FeatureBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Single feature showcase",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "variant",
+          "badge",
+          "title",
+          "description",
+          "features"
+        ],
+        "properties": {
+          "variant": {
+            "required": false,
+            "type": "FeatureBlockVariant"
+          },
+          "badge": {
+            "required": false,
+            "type": "string"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "features": {
+            "required": false,
+            "type": "FeatureGridItem[] | FeatureListItem[]"
+          }
+        }
+      }
+    },
+    "FeatureGridBlock": {
+      "canonicalExport": "FeatureGridBlock",
+      "subpath": "./feature-grid-block",
+      "sourceFile": "src/components/blocks/FeatureGridBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Multi-feature grid layout",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "features"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "features": {
+            "required": false,
+            "type": "FeatureItem[]"
+          }
+        }
+      }
+    },
+    "FooterBlock": {
+      "canonicalExport": "FooterBlock",
+      "subpath": "./footer-block",
+      "sourceFile": "src/components/blocks/FooterBlock.tsx",
+      "category": "Navigation",
+      "tier": "stable",
+      "description": "Site footer with link columns",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "brandDescription",
+          "newsletterPlaceholder",
+          "productLinks",
+          "companyLinks",
+          "legalLinks",
+          "socialIcons"
+        ],
+        "properties": {
+          "brandDescription": {
+            "required": false,
+            "type": "string"
+          },
+          "newsletterPlaceholder": {
+            "required": false,
+            "type": "string"
+          },
+          "productLinks": {
+            "required": false,
+            "type": "NavLink[]"
+          },
+          "companyLinks": {
+            "required": false,
+            "type": "NavLink[]"
+          },
+          "legalLinks": {
+            "required": false,
+            "type": "NavLink[]"
+          },
+          "socialIcons": {
+            "required": false,
+            "type": "{ icon: ReactNode; label: string }[]"
+          }
+        }
+      }
+    },
+    "GalleryBlock": {
+      "canonicalExport": "GalleryBlock",
+      "subpath": "./gallery-block",
+      "sourceFile": "src/components/blocks/GalleryBlock.tsx",
+      "category": "Content & Media",
+      "tier": "stable",
+      "description": "Image/media gallery grid",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "images",
+          "columns",
+          "title"
+        ],
+        "properties": {
+          "images": {
+            "required": false,
+            "type": "GalleryImage[]"
+          },
+          "columns": {
+            "required": false,
+            "type": "number"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "HeaderBlock": {
+      "canonicalExport": "HeaderBlock",
+      "subpath": "./header-block",
+      "sourceFile": "src/components/blocks/HeaderBlock.tsx",
+      "category": "Navigation",
+      "tier": "stable",
+      "description": "Site header with nav links",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "menuItems",
+          "loginLabel",
+          "signUpLabel",
+          "loginHref",
+          "signUpHref"
+        ],
+        "properties": {
+          "menuItems": {
+            "required": false,
+            "type": "MenuItem[]"
+          },
+          "loginLabel": {
+            "required": false,
+            "type": "string"
+          },
+          "signUpLabel": {
+            "required": false,
+            "type": "string"
+          },
+          "loginHref": {
+            "required": false,
+            "type": "string"
+          },
+          "signUpHref": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "HeatmapChartBlock": {
+      "canonicalExport": "HeatmapChartBlock",
+      "subpath": "./heatmap-chart-block",
+      "sourceFile": "src/components/blocks/HeatmapChartBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Heatmap visualization",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "data",
+          "config",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "data": {
+            "required": false,
+            "type": "HeatmapDataItem[]"
+          },
+          "config": {
+            "required": false,
+            "type": "ChartConfig"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "HeroBlock": {
+      "canonicalExport": "HeroBlock",
+      "subpath": "./hero-block",
+      "sourceFile": "src/components/blocks/HeroBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Full hero with gradient text",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "variant",
+          "headline",
+          "subheadline",
+          "primaryAction",
+          "secondaryAction",
+          "announcement"
+        ],
+        "properties": {
+          "variant": {
+            "required": false,
+            "type": "HeroBlockVariant"
+          },
+          "headline": {
+            "required": false,
+            "type": "string"
+          },
+          "subheadline": {
+            "required": false,
+            "type": "string"
+          },
+          "primaryAction": {
+            "required": false,
+            "type": "{ label: string onClick?: () => void }"
+          },
+          "secondaryAction": {
+            "required": false,
+            "type": "{ label: string onClick?: () => void }"
+          },
+          "announcement": {
+            "required": false,
+            "type": "{ label: string text: string href?: string }"
+          }
+        }
+      }
+    },
+    "HeroSectionBlock": {
+      "canonicalExport": "HeroSectionBlock",
+      "subpath": "./hero-section-block",
+      "sourceFile": "src/components/blocks/HeroSectionBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Alternate hero layout",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "headline",
+          "flipWords",
+          "primaryAction",
+          "secondaryAction",
+          "logos"
+        ],
+        "properties": {
+          "headline": {
+            "required": false,
+            "type": "string"
+          },
+          "flipWords": {
+            "required": false,
+            "type": "string[]"
+          },
+          "primaryAction": {
+            "required": false,
+            "type": "HeroAction"
+          },
+          "secondaryAction": {
+            "required": false,
+            "type": "HeroAction"
+          },
+          "logos": {
+            "required": false,
+            "type": "HeroLogo[]"
+          }
+        }
+      }
+    },
+    "IntegrationsBlock": {
+      "canonicalExport": "IntegrationsBlock",
+      "subpath": "./integrations-block",
+      "sourceFile": "src/components/blocks/IntegrationsBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Integration marketplace grid",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "integrations"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "integrations": {
+            "required": false,
+            "type": "IntegrationItem[]"
+          }
+        }
+      }
+    },
+    "InteractiveAreaChartBlock": {
+      "canonicalExport": "InteractiveAreaChartBlock",
+      "subpath": "./interactive-area-chart-block",
+      "sourceFile": "src/components/blocks/InteractiveAreaChartBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Zoomable/interactive area chart",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "data",
+          "config",
+          "title",
+          "description",
+          "timeRanges"
+        ],
+        "properties": {
+          "data": {
+            "required": false,
+            "type": "AreaChartDataItem[]"
+          },
+          "config": {
+            "required": false,
+            "type": "ChartConfig"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "timeRanges": {
+            "required": false,
+            "type": "TimeRange[]"
+          }
+        }
+      }
+    },
+    "InviteUserModal": {
+      "canonicalExport": "InviteUserModal",
+      "subpath": "./user/invite-user-modal",
+      "sourceFile": "src/components/blocks/user/InviteUserModal.tsx",
+      "category": "User",
+      "tier": "stable",
+      "description": "Invite teammate modal with role selection",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "onInvite",
+          "onInvited"
+        ],
+        "properties": {
+          "onInvite": {
+            "required": false,
+            "type": "(values: InviteFormValues) => Promise<InviteResult> | InviteResult"
+          },
+          "onInvited": {
+            "required": false,
+            "type": "() => void"
+          }
+        }
+      }
+    },
+    "KanbanDemoBlock": {
+      "canonicalExport": "KanbanDemoBlock",
+      "subpath": "./kanban-demo-block",
+      "sourceFile": "src/components/blocks/KanbanDemoBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Kanban board demo with sample data",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": true,
+        "required": [],
+        "optional": [],
+        "properties": {}
+      }
+    },
+    "LoginBlock": {
+      "canonicalExport": "LoginBlock",
+      "subpath": "./login-block",
+      "sourceFile": "src/components/blocks/LoginBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "Email/password login with social OAuth",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "type",
+          "showSocial",
+          "labels",
+          "action",
+          "error",
+          "onLogin",
+          "googleAction",
+          "forgotPasswordHref",
+          "signUpHref",
+          "signInHref"
+        ],
+        "properties": {
+          "type": {
+            "required": false,
+            "type": "\"login\" | \"signup\""
+          },
+          "showSocial": {
+            "required": false,
+            "type": "boolean"
+          },
+          "labels": {
+            "required": false,
+            "type": "Partial<typeof defaultLabels>"
+          },
+          "action": {
+            "required": false,
+            "type": "(formData: FormData) => void | Promise<void>"
+          },
+          "error": {
+            "required": false,
+            "type": "string | null"
+          },
+          "onLogin": {
+            "required": false,
+            "type": "(e: FormEvent) => void"
+          },
+          "googleAction": {
+            "required": false,
+            "type": "(formData: FormData) => void | Promise<void>"
+          },
+          "forgotPasswordHref": {
+            "required": false,
+            "type": "string"
+          },
+          "signUpHref": {
+            "required": false,
+            "type": "string"
+          },
+          "signInHref": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "LogoCloud": {
+      "canonicalExport": "LogoCloud",
+      "subpath": "./logo-cloud",
+      "sourceFile": "src/components/blocks/LogoCloud.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Partner/client logo grid",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "logos"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "logos": {
+            "required": false,
+            "type": "LogoItem[]"
+          }
+        }
+      }
+    },
+    "NavUser": {
+      "canonicalExport": "NavUser",
+      "subpath": "./nav-user",
+      "sourceFile": "src/components/blocks/NavUser.tsx",
+      "category": "Navigation",
+      "tier": "stable",
+      "description": "Sidebar user menu with dropdown",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [
+          "user"
+        ],
+        "optional": [
+          "items",
+          "footer"
+        ],
+        "properties": {
+          "user": {
+            "required": true,
+            "type": "{ name: string email: string avatar?: string }"
+          },
+          "items": {
+            "required": false,
+            "type": "NavUserItem[]"
+          },
+          "footer": {
+            "required": false,
+            "type": "React.ReactNode"
+          }
+        }
+      }
+    },
+    "NewsletterBlock": {
+      "canonicalExport": "NewsletterBlock",
+      "subpath": "./newsletter-block",
+      "sourceFile": "src/components/blocks/NewsletterBlock.tsx",
+      "category": "Content & Media",
+      "tier": "stable",
+      "description": "Email newsletter signup",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "onSubscribe",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "onSubscribe": {
+            "required": false,
+            "type": "(email: string) => void"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "NotFoundBlock": {
+      "canonicalExport": "NotFoundBlock",
+      "subpath": "./not-found-block",
+      "sourceFile": "src/components/blocks/NotFoundBlock.tsx",
+      "category": "Navigation",
+      "tier": "stable",
+      "description": "404 page content",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "backHref",
+          "backLabel"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "backHref": {
+            "required": false,
+            "type": "string"
+          },
+          "backLabel": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "OnboardingBlock": {
+      "canonicalExport": "OnboardingBlock",
+      "subpath": "./onboarding-block",
+      "sourceFile": "src/components/blocks/OnboardingBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Multi-step onboarding wizard",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "steps",
+          "title",
+          "onToggle"
+        ],
+        "properties": {
+          "steps": {
+            "required": false,
+            "type": "OnboardingStep[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "onToggle": {
+            "required": false,
+            "type": "(id: string, completed: boolean) => void"
+          }
+        }
+      }
+    },
+    "PasswordRecoveryBlock": {
+      "canonicalExport": "PasswordRecoveryBlock",
+      "subpath": "./password-recovery-block",
+      "sourceFile": "src/components/blocks/PasswordRecoveryBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "Password reset request",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "mode",
+          "onSubmit",
+          "onBackToLogin",
+          "title",
+          "description",
+          "buttonText",
+          "successTitle"
+        ],
+        "properties": {
+          "mode": {
+            "required": false,
+            "type": "\"reset\" | \"magic-link\""
+          },
+          "onSubmit": {
+            "required": false,
+            "type": "(email: string) => void"
+          },
+          "onBackToLogin": {
+            "required": false,
+            "type": "() => void"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "buttonText": {
+            "required": false,
+            "type": "string"
+          },
+          "successTitle": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "PricingBlock": {
+      "canonicalExport": "PricingBlock",
+      "subpath": "./pricing-block",
+      "sourceFile": "src/components/blocks/PricingBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Pricing cards comparison",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "plans",
+          "showBillingToggle"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "plans": {
+            "required": false,
+            "type": "PricingPlan[]"
+          },
+          "showBillingToggle": {
+            "required": false,
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "ProcessFlowBlock": {
+      "canonicalExport": "ProcessFlowBlock",
+      "subpath": "./process-flow-block",
+      "sourceFile": "src/components/blocks/ProcessFlowBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "\"How it works\" numbered step sequence",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "badge",
+          "steps"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "badge": {
+            "required": false,
+            "type": "string"
+          },
+          "steps": {
+            "required": false,
+            "type": "ProcessStep[]"
+          }
+        }
+      }
+    },
+    "ResetPasswordBlock": {
+      "canonicalExport": "ResetPasswordBlock",
+      "subpath": "./reset-password-block",
+      "sourceFile": "src/components/blocks/ResetPasswordBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "New password entry (from email link)",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "onSubmit",
+          "onBackToLogin",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "onSubmit": {
+            "required": false,
+            "type": "(password: string) => void"
+          },
+          "onBackToLogin": {
+            "required": false,
+            "type": "() => void"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "SettingsLayout": {
+      "canonicalExport": "SettingsLayout",
+      "subpath": "./settings-layout",
+      "sourceFile": "src/components/blocks/SettingsLayout.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Settings page with nav sidebar",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "links",
+          "title",
+          "subtitle",
+          "defaultActive",
+          "renderContent"
+        ],
+        "properties": {
+          "links": {
+            "required": false,
+            "type": "SettingsLink[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "subtitle": {
+            "required": false,
+            "type": "string"
+          },
+          "defaultActive": {
+            "required": false,
+            "type": "string"
+          },
+          "renderContent": {
+            "required": false,
+            "type": "(activeLink: string) => ReactNode"
+          }
+        }
+      }
+    },
+    "SignUpBlock": {
+      "canonicalExport": "SignUpBlock",
+      "subpath": "./sign-up-block",
+      "sourceFile": "src/components/blocks/SignUpBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "Registration form",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "showSocial",
+          "signInHref",
+          "onSubmit"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "showSocial": {
+            "required": false,
+            "type": "boolean"
+          },
+          "signInHref": {
+            "required": false,
+            "type": "string"
+          },
+          "onSubmit": {
+            "required": false,
+            "type": "(e: FormEvent<HTMLFormElement>) => void"
+          }
+        }
+      }
+    },
+    "SocialProofBlock": {
+      "canonicalExport": "SocialProofBlock",
+      "subpath": "./social-proof-block",
+      "sourceFile": "src/components/blocks/SocialProofBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Social proof metrics/logos",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "variant",
+          "logos",
+          "title",
+          "testimonials"
+        ],
+        "properties": {
+          "variant": {
+            "required": false,
+            "type": "SocialProofBlockVariant"
+          },
+          "logos": {
+            "required": false,
+            "type": "LogoItem[]"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "testimonials": {
+            "required": false,
+            "type": "SocialTestimonialItem[]"
+          }
+        }
+      }
+    },
+    "SolutionShowcaseBlock": {
+      "canonicalExport": "SolutionShowcaseBlock",
+      "subpath": "./solution-showcase-block",
+      "sourceFile": "src/components/blocks/SolutionShowcaseBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Problem -> Solution -> Output narrative with color-coded arc",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "badge",
+          "sections"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "badge": {
+            "required": false,
+            "type": "string"
+          },
+          "sections": {
+            "required": false,
+            "type": "SolutionSection[]"
+          }
+        }
+      }
+    },
+    "StatsBlock": {
+      "canonicalExport": "StatsBlock",
+      "subpath": "./stats-block",
+      "sourceFile": "src/components/blocks/StatsBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "KPI statistics cards",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "stats"
+        ],
+        "properties": {
+          "stats": {
+            "required": false,
+            "type": "StatItem[]"
+          }
+        }
+      }
+    },
+    "StatsMarketingBlock": {
+      "canonicalExport": "StatsMarketingBlock",
+      "subpath": "./stats-marketing-block",
+      "sourceFile": "src/components/blocks/StatsMarketingBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Marketing statistics display",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "stats"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "stats": {
+            "required": false,
+            "type": "StatItem[]"
+          }
+        }
+      }
+    },
+    "TeamBlock": {
+      "canonicalExport": "TeamBlock",
+      "subpath": "./team-block",
+      "sourceFile": "src/components/blocks/TeamBlock.tsx",
+      "category": "User",
+      "tier": "stable",
+      "description": "Team members grid with roles/avatars",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "sections"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "sections": {
+            "required": false,
+            "type": "TeamSectionDef[]"
+          }
+        }
+      }
+    },
+    "TestimonialsBlock": {
+      "canonicalExport": "TestimonialsBlock",
+      "subpath": "./testimonials-block",
+      "sourceFile": "src/components/blocks/TestimonialsBlock.tsx",
+      "category": "Marketing",
+      "tier": "stable",
+      "description": "Customer testimonial carousel/grid",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "testimonials"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "testimonials": {
+            "required": false,
+            "type": "TestimonialItem[]"
+          }
+        }
+      }
+    },
+    "TwoFactorChallengeBlock": {
+      "canonicalExport": "TwoFactorChallengeBlock",
+      "subpath": "./two-factor-challenge-block",
+      "sourceFile": "src/components/blocks/TwoFactorChallengeBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "2FA code entry challenge",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "onVerify",
+          "onUseBackupCode",
+          "onBackToLogin",
+          "error",
+          "title",
+          "description",
+          "backupCodeLabel"
+        ],
+        "properties": {
+          "onVerify": {
+            "required": false,
+            "type": "(code: string) => void"
+          },
+          "onUseBackupCode": {
+            "required": false,
+            "type": "() => void"
+          },
+          "onBackToLogin": {
+            "required": false,
+            "type": "() => void"
+          },
+          "error": {
+            "required": false,
+            "type": "string"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "backupCodeLabel": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "TwoFactorSetupBlock": {
+      "canonicalExport": "TwoFactorSetupBlock",
+      "subpath": "./two-factor-setup-block",
+      "sourceFile": "src/components/blocks/TwoFactorSetupBlock.tsx",
+      "category": "Auth Flow",
+      "tier": "stable",
+      "description": "2FA setup with QR code",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "qrCodeUrl",
+          "secret",
+          "backupCodes",
+          "onVerify",
+          "onComplete",
+          "title",
+          "description"
+        ],
+        "properties": {
+          "qrCodeUrl": {
+            "required": false,
+            "type": "string"
+          },
+          "secret": {
+            "required": false,
+            "type": "string"
+          },
+          "backupCodes": {
+            "required": false,
+            "type": "string[]"
+          },
+          "onVerify": {
+            "required": false,
+            "type": "(code: string) => boolean | Promise<boolean>"
+          },
+          "onComplete": {
+            "required": false,
+            "type": "() => void"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "UsageDonutBlock": {
+      "canonicalExport": "UsageDonutBlock",
+      "subpath": "./usage-donut-block",
+      "sourceFile": "src/components/blocks/UsageDonutBlock.tsx",
+      "category": "Dashboard & Data",
+      "tier": "stable",
+      "description": "Usage/quota donut chart",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "data",
+          "config",
+          "title",
+          "description",
+          "centerLabel"
+        ],
+        "properties": {
+          "data": {
+            "required": false,
+            "type": "UsageDonutDataItem[]"
+          },
+          "config": {
+            "required": false,
+            "type": "ChartConfig"
+          },
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "centerLabel": {
+            "required": false,
+            "type": "React.ReactNode"
+          }
+        }
+      }
+    },
+    "VoiceAgentCard": {
+      "canonicalExport": "VoiceAgentCard",
+      "subpath": "./voice-agent-card",
+      "sourceFile": "src/components/blocks/VoiceAgentCard.tsx",
+      "category": "AI/Voice",
+      "tier": "stable",
+      "description": "AI voice agent interface card",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [
+          "agent",
+          "state"
+        ],
+        "optional": [
+          "selected",
+          "onSelect",
+          "ariaLabel"
+        ],
+        "properties": {
+          "agent": {
+            "required": true,
+            "type": "VoiceAgent"
+          },
+          "state": {
+            "required": true,
+            "type": "Avatar3DState"
+          },
+          "selected": {
+            "required": false,
+            "type": "boolean"
+          },
+          "onSelect": {
+            "required": false,
+            "type": "() => void"
+          },
+          "ariaLabel": {
+            "required": false,
+            "type": "string"
+          }
+        }
+      }
+    },
+    "WizardBlock": {
+      "canonicalExport": "WizardBlock",
+      "subpath": "./wizard-block",
+      "sourceFile": "src/components/blocks/WizardBlock.tsx",
+      "category": "Application",
+      "tier": "stable",
+      "description": "Generic step-by-step wizard",
+      "propsSchema": {
+        "kind": "object",
+        "noDataProps": false,
+        "required": [],
+        "optional": [
+          "title",
+          "description",
+          "steps",
+          "onFinish"
+        ],
+        "properties": {
+          "title": {
+            "required": false,
+            "type": "string"
+          },
+          "description": {
+            "required": false,
+            "type": "string"
+          },
+          "steps": {
+            "required": false,
+            "type": "WizardStep[]"
+          },
+          "onFinish": {
+            "required": false,
+            "type": "() => void"
+          }
+        }
+      }
+    }
+  }
+}