@vadimcomanescu/nadicode-design-system 2.0.9 → 4.0.1

package/dist/catalog/catalog.js

@@ -0,0 +1,1913 @@
+import { z } from 'zod';
+
+// src/catalog/catalog.ts
+var validationCheckSchema = z.array(
+  z.object({
+    type: z.string(),
+    message: z.string(),
+    args: z.record(z.string(), z.unknown()).optional()
+  })
+).nullable();
+var validateOnSchema = z.enum(["change", "blur", "submit"]).nullable();
+var navigationShellSchema = z.object({
+  workspaceName: z.string(),
+  navigationGroups: z.array(
+    z.object({
+      label: z.string(),
+      items: z.array(
+        z.object({
+          label: z.string(),
+          href: z.string(),
+          icon: z.string().nullable(),
+          badge: z.string().nullable()
+        })
+      )
+    })
+  ),
+  activeHref: z.string().nullable(),
+  breadcrumbs: z.array(z.object({ label: z.string(), href: z.string().nullable() })).nullable()
+});
+var marketingShellSchema = z.object({
+  navigationItems: z.array(z.object({ name: z.string(), href: z.string() })),
+  primaryAction: z.object({ label: z.string(), href: z.string() }).nullable(),
+  secondaryAction: z.object({ label: z.string(), href: z.string() }).nullable()
+});
+var chartConfigSchema = z.record(
+  z.string(),
+  z.object({
+    label: z.string(),
+    color: z.string().nullable()
+  })
+).nullable();
+var trendSchema = z.object({
+  value: z.number(),
+  direction: z.enum(["up", "down", "flat"]).nullable()
+}).nullable();
+var regionStateSchema = z.enum(["loading", "empty", "error", "has-data", "partial-data"]).nullable();
+var seedComponentDefinitions = {
+  // =========================================================================
+  // Blocks (59 entries, alphabetical)
+  // =========================================================================
+  AccountLockedBlock: {
+    props: z.object({
+      reason: z.enum(["too_many_attempts", "suspicious_activity", "admin"]).nullable(),
+      unlockMinutes: z.number().nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    events: ["contactSupport", "backToLogin"],
+    description: "Account locked notification with reason, countdown timer, and support/login actions."
+  },
+  ActivityFeedBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      activities: z.array(
+        z.object({
+          id: z.string(),
+          user: z.string(),
+          action: z.string(),
+          timestamp: z.string(),
+          avatar: z.string().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Chronological activity feed with user avatars, actions, and timestamps."
+  },
+  AgentConversationBlock: {
+    props: z.object({
+      messages: z.array(
+        z.object({
+          id: z.string(),
+          role: z.enum(["user", "assistant", "system"]),
+          content: z.string(),
+          timestamp: z.string().nullable(),
+          isThinking: z.boolean().nullable(),
+          reasoning: z.string().nullable(),
+          isStreaming: z.boolean().nullable(),
+          toolCalls: z.array(
+            z.object({
+              id: z.string(),
+              toolName: z.string(),
+              args: z.record(z.string(), z.unknown()).nullable(),
+              status: z.enum(["pending", "running", "complete", "error"]),
+              result: z.string().nullable(),
+              duration: z.number().nullable()
+            })
+          ).nullable()
+        })
+      )
+    }),
+    description: "AI agent conversation thread with user/assistant messages, tool calls, thinking indicators, and streaming support."
+  },
+  AgentProfileGridBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      columns: z.union([z.literal(2), z.literal(3), z.literal(4)]).nullable(),
+      agents: z.array(
+        z.object({
+          name: z.string(),
+          role: z.string(),
+          description: z.string(),
+          capabilities: z.array(z.string()).nullable(),
+          status: z.enum(["active", "idle", "coming-soon"]).nullable(),
+          href: z.string().nullable(),
+          avatar: z.string()
+        })
+      ).nullable()
+    }),
+    description: "Grid display of AI agent profiles with name, role, capabilities, and status indicators."
+  },
+  AgentRunOverviewBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      teamTitle: z.string().nullable(),
+      metricsTitle: z.string().nullable(),
+      contextTitle: z.string().nullable(),
+      workflow: z.object({
+        title: z.string().nullable(),
+        nodes: z.array(
+          z.object({
+            id: z.string(),
+            label: z.string(),
+            status: z.enum(["pending", "active", "done", "error"])
+          })
+        ),
+        edges: z.array(
+          z.object({ from: z.string(), to: z.string(), label: z.string().nullable() })
+        )
+      }).nullable(),
+      agents: z.array(
+        z.object({
+          id: z.string(),
+          name: z.string(),
+          role: z.string(),
+          status: z.enum(["idle", "active", "complete", "error"]),
+          model: z.string().nullable(),
+          currentAction: z.string().nullable(),
+          tokenCount: z.number().nullable(),
+          cost: z.number().nullable(),
+          elapsedMs: z.number().nullable(),
+          stepsCompleted: z.number().nullable(),
+          stepsTotal: z.number().nullable()
+        })
+      ).nullable(),
+      metrics: z.array(
+        z.object({
+          label: z.string(),
+          value: z.union([z.number(), z.string()]),
+          suffix: z.string().nullable()
+        })
+      ).nullable(),
+      context: z.object({ used: z.number(), total: z.number() }).nullable()
+    }),
+    description: "Agent runtime overview with workflow graph, team panel, metrics, and context window usage."
+  },
+  AgentWorkbenchBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      threadTitle: z.string().nullable(),
+      workTitle: z.string().nullable(),
+      messages: z.array(
+        z.object({
+          id: z.string(),
+          role: z.enum(["user", "assistant"]),
+          content: z.string(),
+          timestamp: z.string().nullable(),
+          toolCalls: z.array(
+            z.object({
+              id: z.string(),
+              toolName: z.string(),
+              status: z.enum(["pending", "running", "complete", "error"])
+            })
+          ).nullable()
+        })
+      ).nullable(),
+      artifacts: z.array(
+        z.object({
+          id: z.string(),
+          type: z.enum(["code", "markdown", "table", "image"]),
+          title: z.string(),
+          content: z.string(),
+          language: z.string().nullable()
+        })
+      ).nullable(),
+      diffs: z.array(
+        z.object({
+          id: z.string(),
+          filePath: z.string(),
+          language: z.string().nullable(),
+          hunks: z.array(
+            z.object({
+              changes: z.array(
+                z.object({
+                  type: z.enum(["add", "remove", "context"]),
+                  content: z.string(),
+                  lineNumber: z.number().nullable()
+                })
+              )
+            })
+          )
+        })
+      ).nullable(),
+      logs: z.array(
+        z.object({
+          text: z.string(),
+          type: z.enum(["stdin", "stdout", "stderr"]).nullable()
+        })
+      ).nullable()
+    }),
+    events: ["composerChange", "composerSend"],
+    description: "Agent workbench with conversation thread, code artifacts, diffs, terminal logs, and composer input."
+  },
+  BannerBlock: {
+    props: z.object({
+      variant: z.enum(["info", "warning", "accent"]).nullable(),
+      dismissible: z.boolean().nullable()
+    }),
+    events: ["dismiss"],
+    slots: ["default"],
+    description: "Dismissible banner notification for info, warning, or accent messages.",
+    example: { variant: "info", dismissible: true }
+  },
+  BarChartBlock: {
+    props: z.object({
+      data: z.array(z.object({ name: z.string(), total: z.number(), prediction: z.number() })).nullable(),
+      config: chartConfigSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    description: "Vertical bar chart with configurable data series and chart configuration."
+  },
+  CallToActionBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      primaryAction: z.object({ label: z.string(), href: z.string() }).nullable(),
+      secondaryAction: z.object({ label: z.string(), href: z.string() }).nullable()
+    }),
+    description: "Call-to-action section with headline, description, and primary/secondary action buttons.",
+    example: {
+      title: "Ready to get started?",
+      primaryAction: { label: "Start now", href: "/signup" }
+    }
+  },
+  ChangelogBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      entries: z.array(
+        z.object({
+          version: z.string(),
+          date: z.string(),
+          changes: z.array(
+            z.object({ type: z.enum(["added", "fixed", "changed"]), text: z.string() })
+          )
+        })
+      ).nullable()
+    }),
+    description: "Changelog display with versioned entries and categorized changes."
+  },
+  ChartBlock: {
+    props: z.object({
+      data: z.array(
+        z.object({
+          month: z.string(),
+          desktop: z.number(),
+          mobile: z.number()
+        })
+      ).nullable(),
+      config: chartConfigSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    description: "Line/area chart comparing desktop and mobile metrics over time."
+  },
+  ChartCollectionBlock: {
+    props: z.object({}),
+    description: "Pre-composed collection of multiple chart types displayed in a dashboard grid."
+  },
+  ComparisonBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      plans: z.array(
+        z.object({
+          name: z.string(),
+          featured: z.boolean().nullable(),
+          features: z.record(
+            z.string(),
+            z.union([z.boolean(), z.string()])
+          )
+        })
+      ).nullable()
+    }),
+    description: "Feature comparison table across multiple plans with boolean and text feature values."
+  },
+  ContactBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      namePlaceholder: z.string().nullable(),
+      emailPlaceholder: z.string().nullable(),
+      messagePlaceholder: z.string().nullable(),
+      successTitle: z.string().nullable(),
+      submitLabel: z.string().nullable()
+    }),
+    events: ["submit"],
+    description: "Contact form with name, email, and message fields. Shows success state after submission.",
+    example: { title: "Get in touch", submitLabel: "Send message" }
+  },
+  CreateBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      submitLabel: z.string().nullable()
+    }),
+    events: ["submit"],
+    description: "Profile creation form with username, email, and bio fields."
+  },
+  DataGridBlock: {
+    props: z.object({
+      data: z.array(
+        z.object({
+          id: z.string(),
+          amount: z.number(),
+          status: z.enum([
+            "pending",
+            "processing",
+            "success",
+            "failed"
+          ]),
+          email: z.string()
+        })
+      ).nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    description: "Data table with sortable columns, row selection, filtering, and pagination."
+  },
+  DirectoryBlock: {
+    props: z.object({
+      navItems: z.array(
+        z.object({
+          name: z.string(),
+          icon: z.string(),
+          isActive: z.boolean().nullable()
+        })
+      ).nullable(),
+      projects: z.array(z.object({ name: z.string(), url: z.string() })).nullable()
+    }),
+    description: "Navigation directory with sidebar items and project listings."
+  },
+  FAQBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      items: z.array(
+        z.object({ question: z.string(), answer: z.string() })
+      ).nullable()
+    }),
+    description: "Accordion-style FAQ section with expandable question/answer pairs.",
+    example: { title: "Frequently Asked Questions" }
+  },
+  FeatureBlock: {
+    props: z.object({
+      variant: z.enum(["grid", "list"]).nullable(),
+      badge: z.string().nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      features: z.array(
+        z.object({
+          title: z.string(),
+          description: z.string(),
+          icon: z.string(),
+          badge: z.string().nullable(),
+          bullets: z.array(z.string()).nullable()
+        })
+      ).nullable()
+    }),
+    description: "Feature showcase in grid or list layout with icons, descriptions, and optional badges."
+  },
+  FeatureGridBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      features: z.array(
+        z.object({
+          title: z.string(),
+          description: z.string(),
+          icon: z.string()
+        })
+      ).nullable()
+    }),
+    description: "Simple feature grid with title and description per feature card."
+  },
+  FooterBlock: {
+    props: z.object({
+      brandDescription: z.string().nullable(),
+      newsletterPlaceholder: z.string().nullable(),
+      productLinks: z.array(z.object({ name: z.string(), href: z.string() })).nullable(),
+      companyLinks: z.array(z.object({ name: z.string(), href: z.string() })).nullable(),
+      legalLinks: z.array(z.object({ name: z.string(), href: z.string() })).nullable()
+    }),
+    description: "Site footer with brand description, navigation columns, newsletter signup, and social icons.",
+    example: { brandDescription: "The ultimate design system." }
+  },
+  GalleryBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      columns: z.number().nullable(),
+      images: z.array(
+        z.object({
+          src: z.string(),
+          alt: z.string(),
+          caption: z.string().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Image gallery grid with configurable columns and optional captions."
+  },
+  HeaderBlock: {
+    props: z.object({
+      menuItems: z.array(z.object({ name: z.string(), href: z.string() })).nullable(),
+      loginLabel: z.string().nullable(),
+      signUpLabel: z.string().nullable(),
+      loginHref: z.string().nullable(),
+      signUpHref: z.string().nullable()
+    }),
+    description: "Site header with logo, navigation menu, and auth action buttons. Responsive with mobile hamburger menu.",
+    example: {
+      menuItems: [{ name: "Features", href: "#features" }],
+      loginLabel: "Login"
+    }
+  },
+  HeatmapChartBlock: {
+    props: z.object({
+      data: z.array(
+        z.object({
+          x: z.string(),
+          y: z.string(),
+          value: z.number()
+        })
+      ).nullable(),
+      config: chartConfigSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    description: "Heatmap chart with X/Y grid cells colored by value intensity."
+  },
+  HeroBlock: {
+    props: z.object({
+      variant: z.enum(["centered", "split"]).nullable(),
+      headline: z.string().nullable(),
+      subheadline: z.string().nullable(),
+      primaryAction: z.object({ label: z.string() }).nullable(),
+      secondaryAction: z.object({ label: z.string() }).nullable(),
+      announcement: z.object({
+        label: z.string(),
+        text: z.string(),
+        href: z.string().nullable()
+      }).nullable()
+    }),
+    events: ["primaryAction", "secondaryAction"],
+    description: "Hero section with headline, subheadline, and call-to-action buttons. Supports centered and split variants.",
+    example: {
+      variant: "centered",
+      headline: "Build faster",
+      primaryAction: { label: "Get Started" }
+    }
+  },
+  HeroSectionBlock: {
+    props: z.object({
+      headline: z.string().nullable(),
+      flipWords: z.array(z.string()).nullable(),
+      primaryAction: z.object({ label: z.string(), href: z.string() }).nullable(),
+      secondaryAction: z.object({ label: z.string(), href: z.string() }).nullable(),
+      logos: z.array(
+        z.object({
+          src: z.string(),
+          alt: z.string(),
+          height: z.string()
+        })
+      ).nullable()
+    }),
+    description: "Hero section with animated flip-word headline, dual CTAs, and logo slider."
+  },
+  IntegrationsBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      integrations: z.array(
+        z.object({
+          title: z.string(),
+          description: z.string(),
+          icon: z.string(),
+          link: z.string().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Grid of integration cards with title, description, and optional link."
+  },
+  InteractiveAreaChartBlock: {
+    props: z.object({
+      data: z.array(
+        z.object({
+          date: z.string(),
+          desktop: z.number(),
+          mobile: z.number()
+        })
+      ).nullable(),
+      config: chartConfigSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      timeRanges: z.array(
+        z.object({
+          value: z.string(),
+          label: z.string(),
+          days: z.number()
+        })
+      ).nullable()
+    }),
+    description: "Interactive area chart with time range selector and configurable data series."
+  },
+  LoginBlock: {
+    props: z.object({
+      type: z.enum(["login", "signup"]).nullable(),
+      showSocial: z.boolean().nullable(),
+      error: z.string().nullable(),
+      forgotPasswordHref: z.string().nullable(),
+      signUpHref: z.string().nullable(),
+      signInHref: z.string().nullable()
+    }),
+    events: ["submit", "socialLogin"],
+    description: "Authentication login form with email/password fields and optional social login buttons.",
+    example: { showSocial: true, forgotPasswordHref: "/reset-password" }
+  },
+  NewsletterBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    events: ["subscribe"],
+    description: "Newsletter signup form with email input and subscribe button."
+  },
+  OnboardingBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      steps: z.array(
+        z.object({
+          id: z.string(),
+          title: z.string(),
+          description: z.string(),
+          completed: z.boolean()
+        })
+      ).nullable()
+    }),
+    events: ["toggle"],
+    description: "Onboarding checklist with toggleable step completion tracking."
+  },
+  PasswordRecoveryBlock: {
+    props: z.object({
+      mode: z.enum(["reset", "magic-link"]).nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      buttonText: z.string().nullable(),
+      successTitle: z.string().nullable()
+    }),
+    events: ["submit", "backToLogin"],
+    description: "Password recovery form with email input. Supports reset and magic-link modes."
+  },
+  PricingBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      showBillingToggle: z.boolean().nullable(),
+      plans: z.array(
+        z.object({
+          name: z.string(),
+          description: z.string(),
+          price: z.string(),
+          period: z.string(),
+          features: z.array(z.string()),
+          action: z.string(),
+          variant: z.string(),
+          popular: z.boolean().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Pricing table with plan comparison, billing toggle, and feature lists.",
+    example: { title: "Simple, transparent pricing", showBillingToggle: true }
+  },
+  ProcessFlowBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      badge: z.string().nullable(),
+      steps: z.array(
+        z.object({
+          title: z.string(),
+          description: z.string()
+        })
+      ).nullable()
+    }),
+    description: "Step-by-step process flow diagram with numbered steps and descriptions."
+  },
+  ResetPasswordBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    events: ["submit", "backToLogin"],
+    description: "New password form with password confirmation. Shown after recovery link click."
+  },
+  SignUpBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      showSocial: z.boolean().nullable(),
+      signInHref: z.string().nullable()
+    }),
+    events: ["submit"],
+    description: "Sign-up form with name, email, and password fields. Optional social login buttons.",
+    example: { title: "Create an Account", showSocial: true }
+  },
+  SocialProofBlock: {
+    props: z.object({
+      variant: z.enum(["logo-cloud", "testimonials"]).nullable(),
+      title: z.string().nullable(),
+      testimonials: z.array(
+        z.object({
+          quote: z.string(),
+          author: z.string(),
+          role: z.string(),
+          avatar: z.string()
+        })
+      ).nullable()
+    }),
+    description: "Social proof section with logo cloud or customer testimonial carousel."
+  },
+  SolutionShowcaseBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      badge: z.string().nullable(),
+      sections: z.array(
+        z.object({
+          label: z.string(),
+          title: z.string(),
+          description: z.string(),
+          bullets: z.array(z.string())
+        })
+      ).nullable(),
+      className: z.string().nullable()
+    }),
+    description: "Problem/solution/output showcase with three glass-panel cards and animated stagger entrance."
+  },
+  StatsBlock: {
+    props: z.object({
+      stats: z.array(
+        z.object({
+          title: z.string(),
+          value: z.union([z.number(), z.string()]),
+          trend: trendSchema,
+          sparklineData: z.array(z.number()).nullable(),
+          periodText: z.string().nullable(),
+          prefix: z.string().nullable(),
+          suffix: z.string().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Statistics display with trend indicators, sparklines, and formatted values.",
+    example: {
+      stats: [
+        {
+          title: "Revenue",
+          value: 45231,
+          prefix: "$",
+          trend: { value: 12, direction: "up" }
+        }
+      ]
+    }
+  },
+  StatsMarketingBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      stats: z.array(
+        z.object({
+          value: z.number(),
+          label: z.string(),
+          suffix: z.string().nullable(),
+          prefix: z.string().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Marketing statistics section with animated counting numbers and labels."
+  },
+  TeamBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      sections: z.array(
+        z.object({
+          heading: z.string(),
+          members: z.array(
+            z.object({
+              name: z.string(),
+              role: z.string(),
+              avatar: z.string()
+            })
+          )
+        })
+      ).nullable()
+    }),
+    description: "Team showcase with sectioned member grids showing avatars, names, and roles."
+  },
+  TestimonialsBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      testimonials: z.array(
+        z.object({
+          quote: z.string(),
+          author: z.string(),
+          role: z.string(),
+          avatar: z.string(),
+          featured: z.boolean().nullable()
+        })
+      ).nullable()
+    }),
+    description: "Customer testimonials with quotes, author info, and optional featured highlighting."
+  },
+  TwoFactorChallengeBlock: {
+    props: z.object({
+      error: z.string().nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      backupCodeLabel: z.string().nullable()
+    }),
+    events: ["verify", "useBackupCode", "backToLogin"],
+    description: "Two-factor authentication code entry with 6-digit OTP input and backup code option."
+  },
+  TwoFactorSetupBlock: {
+    props: z.object({
+      qrCodeUrl: z.string().nullable(),
+      secret: z.string().nullable(),
+      backupCodes: z.array(z.string()).nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    events: ["verify", "complete"],
+    description: "Two-factor setup wizard with QR code, secret key display, backup codes, and verification."
+  },
+  UsageDonutBlock: {
+    props: z.object({
+      data: z.array(
+        z.object({
+          name: z.string(),
+          value: z.number(),
+          fill: z.string()
+        })
+      ).nullable(),
+      config: chartConfigSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    description: "Donut chart showing usage breakdown by category with center label."
+  },
+  AudioVisualizerBlock: {
+    props: z.object({
+      bars: z.number().nullable(),
+      isPlaying: z.boolean().nullable(),
+      className: z.string().nullable()
+    }),
+    description: "Animated audio visualizer bar display. Use inside voice or audio playback UIs. Set isPlaying to animate bars; bars controls the count (default 20)."
+  },
+  AuthLayout: {
+    props: z.object({
+      mode: z.enum(["login", "signup"]).nullable(),
+      error: z.string().nullable(),
+      labels: z.object({
+        headline: z.string().nullable(),
+        quote: z.string().nullable(),
+        quoteAttribution: z.string().nullable()
+      }).nullable(),
+      className: z.string().nullable()
+    }),
+    slots: ["default"],
+    description: "Full-page split auth layout with animated visual side and form side. Renders a LoginBlock internally. Use as the shell for login and signup pages when you need the branded two-column layout."
+  },
+  AuthSuccessBlock: {
+    props: z.object({
+      title: z.string(),
+      description: z.string(),
+      buttonText: z.string().nullable(),
+      autoRedirectSeconds: z.number().nullable()
+    }),
+    slots: ["icon"],
+    events: ["continue"],
+    description: "Success confirmation card with icon slot, title, description, continue button, and optional auto-redirect countdown. Use after successful auth flows (email verified, password reset)."
+  },
+  ChatLayout: {
+    props: z.object({
+      assistantName: z.string().nullable(),
+      assistantStatus: z.string().nullable(),
+      placeholder: z.string().nullable(),
+      initialMessages: z.array(
+        z.object({
+          id: z.string(),
+          role: z.enum(["user", "assistant"]),
+          content: z.string()
+        })
+      ).nullable(),
+      className: z.string().nullable()
+    }),
+    description: "Self-contained chat widget with message history, send form, and simulated assistant replies. Suitable for embedded chat demos and prototype UIs. For full-page agent chat use AgentsChatPageKit."
+  },
+  CheckoutForm: {
+    props: z.object({
+      amount: z.number().nullable(),
+      currency: z.string().nullable(),
+      returnUrl: z.string().nullable()
+    }),
+    description: "Stripe payment form card using Stripe.js PaymentElement. Must be rendered inside a Stripe Elements provider. Handles submission, loading, and error states. amount is in cents (default 2000)."
+  },
+  CodeBlock: {
+    props: z.object({
+      code: z.string(),
+      language: z.string().nullable(),
+      filename: z.string().nullable(),
+      className: z.string().nullable()
+    }),
+    description: "Syntax-highlighted code display with copy button and optional filename header. Uses Prism.js for highlighting. Wrap in ScrollFadeIn entrance animation automatically."
+  },
+  FormWizard: {
+    props: z.object({
+      activeStep: z.number().nullable(),
+      nextLabel: z.string().nullable(),
+      backLabel: z.string().nullable(),
+      completeLabel: z.string().nullable(),
+      variant: z.string().nullable(),
+      size: z.string().nullable(),
+      className: z.string().nullable()
+    }),
+    slots: ["steps"],
+    events: ["stepChange", "complete"],
+    description: "Multi-step wizard with animated step transitions, progress indicators, and back/next/complete navigation. Steps are passed as WizardStep objects with id, title, description, and content. Supports controlled (activeStep + onStepChange) and uncontrolled modes."
+  },
+  InviteUserModal: {
+    props: z.object({}),
+    events: ["invite", "invited"],
+    description: "Self-contained invite teammate modal triggered by a button. Renders a dialog with email and role (admin/member/guest) fields, Zod validation, and async submission. Use inside team management UIs."
+  },
+  KanbanBoard: {
+    props: z.object({
+      activationDistance: z.number().nullable(),
+      className: z.string().nullable()
+    }),
+    slots: ["default"],
+    events: ["valueChange"],
+    description: "Headless drag-and-drop Kanban board primitive. Compose with KanbanColumn, KanbanColumnHeader, KanbanItem, and KanbanHandle sub-components. Controlled via value + onValueChange. Use KanbanBoardPageKit for a full-page opinionated implementation."
+  },
+  KanbanDemoBlock: {
+    props: z.object({
+      className: z.string().nullable()
+    }),
+    description: "Pre-configured Kanban demo with sample task data across five columns (Backlog, Todo, In Progress, Review, Done). Wraps KanbanBoard with a complete task card layout including priority badges, assignee avatars, and tag pills."
+  },
+  LogoCloud: {
+    props: z.object({
+      title: z.string().nullable(),
+      logos: z.array(
+        z.object({
+          src: z.string(),
+          alt: z.string(),
+          height: z.number()
+        })
+      ).nullable(),
+      className: z.string().nullable()
+    }),
+    description: "Partner/customer logo grid with title. Logos auto-invert in dark mode. Use as a social proof section on marketing pages."
+  },
+  NavUser: {
+    props: z.object({
+      user: z.object({
+        name: z.string(),
+        email: z.string(),
+        avatar: z.string().nullable()
+      }),
+      items: z.array(
+        z.object({
+          label: z.string(),
+          href: z.string().nullable()
+        })
+      ).nullable()
+    }),
+    slots: ["footer"],
+    description: "Sidebar user menu button with avatar, name, email, and dropdown actions. Renders inside a SidebarMenu. Used in the sidebar footer of NavigationShellPageKit."
+  },
+  NotFoundBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      backHref: z.string().nullable(),
+      backLabel: z.string().nullable(),
+      className: z.string().nullable()
+    }),
+    description: "404 not-found section with animated gradient title, description, and back-home button. Embeds a MeteorShower background effect. Use on error and not-found pages."
+  },
+  SettingsLayout: {
+    props: z.object({
+      title: z.string().nullable(),
+      subtitle: z.string().nullable(),
+      defaultActive: z.string().nullable(),
+      links: z.array(
+        z.object({
+          label: z.string(),
+          badge: z.string().nullable()
+        })
+      ).nullable(),
+      className: z.string().nullable()
+    }),
+    slots: ["sectionContent"],
+    events: ["activeChange"],
+    description: "Settings shell with collapsible sidebar navigation and animated content area. Provide renderContent to supply per-section content. For a full-page implementation with save/discard controls use SettingsPageKit."
+  },
+  VoiceAgentCard: {
+    props: z.object({
+      agent: z.object({
+        id: z.string(),
+        name: z.string(),
+        role: z.string(),
+        avatar: z.string()
+      }),
+      state: z.enum(["idle", "listening", "speaking"]),
+      selected: z.boolean().nullable(),
+      ariaLabel: z.string().nullable(),
+      className: z.string().nullable()
+    }),
+    events: ["select"],
+    description: "Voice agent selection card with 3D avatar, name, role, and state badge (idle/listening/speaking). Supports selected highlight and press animation. Use in a grid inside VoiceAgentsPageKit or standalone voice agent UIs."
+  },
+  WizardBlock: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      steps: z.array(
+        z.object({
+          title: z.string(),
+          description: z.string()
+        })
+      ).nullable(),
+      className: z.string().nullable()
+    }),
+    events: ["finish"],
+    description: "Opinionated multi-step wizard card with Stepper progress indicator and built-in step content slots. Handles account, profile, plan, and launch steps by default. Use for onboarding and setup flows."
+  },
+  // =========================================================================
+  // Page Kits (28 entries, alphabetical)
+  // =========================================================================
+  AccountLockedPageKit: {
+    props: z.object({
+      reason: z.enum(["too_many_attempts", "suspicious_activity", "admin"]).nullable(),
+      unlockMinutes: z.number().nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    events: ["contactSupport", "backToLogin"],
+    description: "Full-page account locked screen with reason display and support/login actions."
+  },
+  AgentsChatPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      state: z.enum([
+        "empty",
+        "loading",
+        "thinking",
+        "blocked-approval",
+        "failed",
+        "running",
+        "complete"
+      ]).nullable(),
+      messages: z.array(
+        z.object({
+          id: z.string(),
+          role: z.enum(["user", "assistant", "system"]),
+          content: z.string(),
+          timestamp: z.string().nullable()
+        })
+      ).nullable(),
+      toolCalls: z.array(
+        z.object({
+          id: z.string(),
+          toolName: z.string(),
+          status: z.enum(["pending", "running", "complete", "error"]),
+          result: z.string().nullable(),
+          durationMs: z.number().nullable()
+        })
+      ).nullable(),
+      artifacts: z.array(
+        z.object({
+          id: z.string(),
+          title: z.string(),
+          kind: z.enum(["diff", "file", "log", "report"]),
+          summary: z.string()
+        })
+      ).nullable(),
+      traceEvents: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          detail: z.string()
+        })
+      ).nullable(),
+      errorMessage: z.string().nullable(),
+      composer: z.object({
+        value: z.string().nullable(),
+        placeholder: z.string().nullable(),
+        disabled: z.boolean().nullable()
+      }).nullable(),
+      approval: z.object({ pendingReason: z.string() }).nullable()
+    }),
+    events: ["approve", "reject", "composerChange", "composerSend"],
+    description: "Full-page AI agent chat interface with conversation, tool calls, artifacts, trace events, and approval workflow."
+  },
+  AnalyticsPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      comparisonLabel: z.string().nullable(),
+      filters: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          value: z.string(),
+          options: z.array(
+            z.object({ value: z.string(), label: z.string() })
+          )
+        })
+      ).nullable()
+    }),
+    events: ["resetFilters", "filterChange"],
+    slots: ["chartRegions"],
+    description: "Analytics dashboard with filter controls, chart regions, and data grid regions."
+  },
+  BlogContentPageKit: {
+    props: z.object({
+      shell: marketingShellSchema,
+      state: z.enum([
+        "loading",
+        "empty",
+        "filtered",
+        "has-data",
+        "paginated"
+      ]).nullable(),
+      variant: z.enum(["content-index", "content-detail", "changelog"]).nullable(),
+      categories: z.array(
+        z.object({ id: z.string(), label: z.string() })
+      ).nullable(),
+      activeCategoryId: z.string().nullable(),
+      articles: z.array(
+        z.object({
+          id: z.string(),
+          title: z.string(),
+          excerpt: z.string(),
+          category: z.string(),
+          authorName: z.string(),
+          authorFallback: z.string().nullable(),
+          readTimeLabel: z.string().nullable(),
+          publishedAt: z.string()
+        })
+      ).nullable(),
+      detail: z.object({
+        title: z.string(),
+        content: z.string(),
+        authorName: z.string(),
+        authorFallback: z.string().nullable(),
+        publishedAt: z.string(),
+        readTimeLabel: z.string().nullable(),
+        excerpt: z.string().nullable()
+      }).nullable(),
+      loadingMessage: z.string().nullable()
+    }),
+    events: ["categoryChange", "pageChange", "articleOpen"],
+    description: "Blog/content management page with article index, detail view, and changelog variants."
+  },
+  CheckoutPageKit: {
+    props: z.object({
+      shell: marketingShellSchema,
+      state: z.enum([
+        "default",
+        "submitting",
+        "processing",
+        "error",
+        "success"
+      ]).nullable(),
+      summary: z.object({
+        title: z.string(),
+        amountLabel: z.string(),
+        lineItems: z.array(
+          z.object({
+            id: z.string(),
+            label: z.string(),
+            value: z.string()
+          })
+        )
+      }),
+      billingFields: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          value: z.string(),
+          placeholder: z.string().nullable(),
+          type: z.enum(["text", "email", "tel"]).nullable(),
+          required: z.boolean().nullable(),
+          description: z.string().nullable()
+        })
+      ),
+      errorMessage: z.string().nullable(),
+      successMessage: z.string().nullable(),
+      processingMessage: z.string().nullable()
+    }),
+    events: ["billingFieldChange", "submit", "retry", "continue"],
+    description: "Checkout page with order summary, billing fields, and multi-state submission flow."
+  },
+  CompanySuitePageKit: {
+    props: z.object({
+      shell: marketingShellSchema,
+      variant: z.enum(["company-about", "company-contact"]).nullable(),
+      sectionOrder: z.array(z.enum(["narrative", "team", "contact", "faq", "cta"])).nullable(),
+      narrative: z.object({
+        title: z.string(),
+        description: z.string().nullable()
+      }).nullable(),
+      team: z.object({
+        title: z.string().nullable(),
+        sections: z.array(
+          z.object({
+            heading: z.string(),
+            members: z.array(
+              z.object({
+                name: z.string(),
+                role: z.string(),
+                avatar: z.string()
+              })
+            )
+          })
+        ).nullable()
+      }).nullable(),
+      contact: z.object({ title: z.string().nullable() }).nullable(),
+      faq: z.object({
+        title: z.string().nullable(),
+        items: z.array(
+          z.object({
+            question: z.string(),
+            answer: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      cta: z.object({
+        title: z.string().nullable(),
+        primaryAction: z.object({ label: z.string(), href: z.string() }).nullable()
+      }).nullable()
+    }),
+    events: ["contactSubmit"],
+    description: "Company pages with configurable sections: about narrative, team, contact form, FAQ, and CTA."
+  },
+  CrudFormPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      state: z.enum([
+        "pristine",
+        "dirty",
+        "validating",
+        "validation-error",
+        "submitting",
+        "saved",
+        "fatal-error"
+      ]).nullable(),
+      sections: z.array(
+        z.object({
+          id: z.string(),
+          title: z.string(),
+          description: z.string().nullable(),
+          optional: z.boolean().nullable(),
+          fields: z.array(
+            z.object({
+              id: z.string(),
+              label: z.string(),
+              value: z.string(),
+              type: z.enum(["text", "email", "number", "textarea", "select"]).nullable(),
+              placeholder: z.string().nullable(),
+              required: z.boolean().nullable(),
+              readOnly: z.boolean().nullable(),
+              errorMessage: z.string().nullable(),
+              options: z.array(
+                z.object({
+                  value: z.string(),
+                  label: z.string()
+                })
+              ).nullable()
+            })
+          ).nullable()
+        })
+      ).nullable(),
+      validationMessage: z.string().nullable(),
+      fatalErrorMessage: z.string().nullable(),
+      savedMessage: z.string().nullable()
+    }),
+    events: [
+      "fieldChange",
+      "primaryAction",
+      "secondaryAction",
+      "tertiaryAction",
+      "destructiveAction"
+    ],
+    description: "Generic CRUD form page with sectioned fields, validation states, and configurable actions."
+  },
+  CrudListDetailPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      state: z.enum([
+        "loading",
+        "empty",
+        "filtered",
+        "selected-row",
+        "error",
+        "has-data"
+      ]).nullable(),
+      columns: z.array(
+        z.object({
+          id: z.string(),
+          header: z.string()
+        })
+      ).nullable(),
+      rows: z.array(
+        z.object({
+          id: z.string(),
+          cells: z.record(z.string(), z.string())
+        })
+      ).nullable(),
+      selectedRowId: z.string().nullable(),
+      filterControls: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          value: z.string(),
+          placeholder: z.string().nullable()
+        })
+      ).nullable(),
+      pagination: z.object({
+        page: z.number(),
+        totalPages: z.number()
+      }),
+      errorMessage: z.string().nullable()
+    }),
+    events: ["rowSelect", "pageChange", "filterChange"],
+    description: "Master-detail list page with data table, filters, pagination, and detail panel."
+  },
+  DashboardPageKit: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      kpis: z.array(
+        z.object({
+          label: z.string(),
+          value: z.union([z.number(), z.string()]),
+          trend: trendSchema,
+          sparklineData: z.array(z.number()).nullable(),
+          prefix: z.string().nullable(),
+          suffix: z.string().nullable(),
+          loading: z.boolean().nullable()
+        })
+      ).nullable(),
+      kpiState: regionStateSchema,
+      lastUpdated: z.string().nullable(),
+      shell: navigationShellSchema
+    }),
+    events: ["sidebarOpenChange"],
+    slots: ["chartRegions"],
+    description: "Full dashboard page with navigation shell, KPI cards, chart regions, and activity feed. Requires shell configuration for sidebar navigation.",
+    example: {
+      title: "Dashboard",
+      shell: {
+        workspaceName: "Acme Corp",
+        navigationGroups: [],
+        activeHref: "/dashboard"
+      },
+      kpis: [
+        {
+          label: "Revenue",
+          value: "$45,231",
+          trend: { value: 12, direction: "up" }
+        }
+      ]
+    }
+  },
+  ErrorPageKit: {
+    props: z.object({
+      variant: z.enum(["not-found", "server-error", "generic-fallback"]),
+      title: z.string(),
+      description: z.string(),
+      metadata: z.object({
+        statusCode: z.number().nullable(),
+        errorCode: z.string().nullable(),
+        incidentId: z.string().nullable()
+      }).nullable(),
+      primaryAction: z.object({ label: z.string() }).nullable(),
+      secondaryAction: z.object({ label: z.string() }).nullable()
+    }),
+    events: ["primaryAction", "secondaryAction"],
+    slots: ["supportContent"],
+    description: "Error page with status display, action buttons, and optional support content."
+  },
+  KanbanBoardPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      state: z.enum([
+        "loading",
+        "empty",
+        "dragging",
+        "move-failed",
+        "has-data"
+      ]).nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      columns: z.array(
+        z.object({
+          id: z.string(),
+          title: z.string(),
+          items: z.array(
+            z.object({
+              id: z.string(),
+              title: z.string(),
+              description: z.string().nullable(),
+              badgeLabel: z.string().nullable(),
+              assigneeLabel: z.string().nullable()
+            })
+          ),
+          disabled: z.boolean().nullable()
+        })
+      ).nullable(),
+      readOnly: z.boolean().nullable(),
+      moveErrorMessage: z.string().nullable()
+    }),
+    events: ["move"],
+    slots: ["activityRegion"],
+    description: "Kanban board page with draggable card columns, move tracking, and activity region."
+  },
+  LandingPageKit: {
+    props: z.object({
+      shell: marketingShellSchema,
+      sectionOrder: z.array(
+        z.enum([
+          "hero",
+          "features",
+          "proof",
+          "pricing-teaser",
+          "faq",
+          "cta",
+          "newsletter"
+        ])
+      ).nullable(),
+      hero: z.object({
+        variant: z.enum(["centered", "split"]).nullable(),
+        headline: z.string().nullable(),
+        subheadline: z.string().nullable(),
+        primaryAction: z.object({ label: z.string() }).nullable(),
+        secondaryAction: z.object({ label: z.string() }).nullable()
+      }).nullable(),
+      features: z.object({
+        variant: z.enum(["grid", "list"]).nullable(),
+        badge: z.string().nullable(),
+        title: z.string().nullable(),
+        description: z.string().nullable(),
+        features: z.array(
+          z.object({
+            title: z.string(),
+            description: z.string(),
+            icon: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      proof: z.object({
+        testimonials: z.object({
+          title: z.string().nullable(),
+          testimonials: z.array(
+            z.object({
+              quote: z.string(),
+              author: z.string(),
+              role: z.string(),
+              avatar: z.string()
+            })
+          ).nullable()
+        }).nullable()
+      }).nullable(),
+      pricingTeaser: z.object({
+        title: z.string().nullable(),
+        plans: z.array(
+          z.object({
+            name: z.string(),
+            description: z.string(),
+            price: z.string(),
+            period: z.string(),
+            features: z.array(z.string()),
+            action: z.string(),
+            variant: z.string(),
+            popular: z.boolean().nullable()
+          })
+        ).nullable()
+      }).nullable(),
+      faq: z.object({
+        items: z.array(
+          z.object({
+            question: z.string(),
+            answer: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      cta: z.object({
+        title: z.string().nullable(),
+        primaryAction: z.object({ label: z.string(), href: z.string() }).nullable()
+      }).nullable(),
+      newsletter: z.object({ title: z.string().nullable() }).nullable()
+    }),
+    events: [
+      "heroPrimaryAction",
+      "heroSecondaryAction",
+      "newsletterSubscribe"
+    ],
+    description: "Full landing page with configurable sections: hero, features, social proof, pricing teaser, FAQ, CTA, and newsletter."
+  },
+  LoginPageKit: {
+    props: z.object({
+      showSocial: z.boolean().nullable(),
+      forgotPasswordHref: z.string().nullable(),
+      signUpHref: z.string().nullable(),
+      error: z.string().nullable(),
+      cardClassName: z.string().nullable()
+    }),
+    events: ["submit", "socialLogin"],
+    description: "Full-page login experience with centered card layout, social login options, and error display.",
+    example: { showSocial: true, forgotPasswordHref: "/reset-password" }
+  },
+  MarketingShellPageKit: {
+    props: z.object({
+      navigationItems: z.array(
+        z.object({ name: z.string(), href: z.string() })
+      ),
+      primaryAction: z.object({ label: z.string(), href: z.string() }).nullable(),
+      secondaryAction: z.object({ label: z.string(), href: z.string() }).nullable(),
+      contentClassName: z.string().nullable()
+    }),
+    slots: ["default", "announcement"],
+    description: "Marketing page shell with top navigation, header actions, footer, and announcement slot."
+  },
+  NavigationShellPageKit: {
+    props: z.object({
+      workspaceName: z.string(),
+      navigationGroups: z.array(
+        z.object({
+          label: z.string(),
+          items: z.array(
+            z.object({
+              label: z.string(),
+              href: z.string(),
+              icon: z.string().nullable(),
+              badge: z.string().nullable()
+            })
+          )
+        })
+      ),
+      activeHref: z.string().nullable(),
+      breadcrumbs: z.array(
+        z.object({
+          label: z.string(),
+          href: z.string().nullable()
+        })
+      ).nullable(),
+      emptyNavigationMessage: z.string().nullable(),
+      user: z.object({
+        name: z.string(),
+        avatarSrc: z.string().nullable(),
+        avatarFallback: z.string().nullable()
+      }).nullable(),
+      defaultSidebarOpen: z.boolean().nullable()
+    }),
+    events: ["sidebarOpenChange"],
+    slots: ["default", "headerSearch", "headerNotifications", "headerActions"],
+    description: "Application shell with collapsible sidebar navigation, breadcrumbs, header slots, and user menu."
+  },
+  OnboardingPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      steps: z.array(
+        z.object({
+          id: z.string(),
+          title: z.string(),
+          description: z.string().nullable(),
+          optional: z.boolean().nullable()
+        })
+      ),
+      activeStepIndex: z.number(),
+      state: z.enum(["default", "saving", "active-step", "complete"]).nullable(),
+      validationMessage: z.string().nullable(),
+      canSkipOptionalStep: z.boolean().nullable(),
+      completeTitle: z.string().nullable(),
+      completeDescription: z.string().nullable()
+    }),
+    events: ["stepChange", "complete", "back", "continueFromComplete"],
+    slots: ["stepContent"],
+    description: "Multi-step onboarding wizard with progress tracking, step navigation, and completion screen."
+  },
+  PricingPageKit: {
+    props: z.object({
+      shell: marketingShellSchema,
+      state: z.enum([
+        "default",
+        "billing-toggle",
+        "loading-action",
+        "empty-plan"
+      ]).nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      plans: z.array(
+        z.object({
+          name: z.string(),
+          description: z.string(),
+          price: z.string(),
+          period: z.string(),
+          features: z.array(z.string()),
+          action: z.string(),
+          variant: z.string(),
+          popular: z.boolean().nullable()
+        })
+      ).nullable(),
+      billing: z.object({
+        monthlyLabel: z.string().nullable(),
+        yearlyLabel: z.string().nullable(),
+        yearlyBadgeLabel: z.string().nullable(),
+        supportsYearly: z.boolean().nullable()
+      }).nullable(),
+      comparison: z.object({
+        title: z.string().nullable(),
+        plans: z.array(
+          z.object({
+            name: z.string(),
+            featured: z.boolean().nullable(),
+            features: z.record(
+              z.string(),
+              z.union([z.boolean(), z.string()])
+            )
+          })
+        ).nullable()
+      }).nullable(),
+      faq: z.object({
+        items: z.array(
+          z.object({
+            question: z.string(),
+            answer: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      cta: z.object({
+        title: z.string().nullable(),
+        primaryAction: z.object({ label: z.string(), href: z.string() }).nullable()
+      }).nullable(),
+      planActions: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          href: z.string(),
+          disabled: z.boolean().nullable()
+        })
+      ).nullable(),
+      loadingMessage: z.string().nullable()
+    }),
+    events: ["planAction"],
+    description: "Full pricing page with plan cards, billing toggle, comparison table, FAQ, and CTA sections."
+  },
+  ProfileSettingsPageKit: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      activeSectionId: z.string().nullable(),
+      mode: z.enum(["edit", "view"]).nullable(),
+      saveState: z.enum([
+        "default",
+        "dirty",
+        "saving",
+        "saved",
+        "validation-error",
+        "fatal-error",
+        "loading"
+      ]).nullable(),
+      profileFields: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          value: z.string(),
+          type: z.enum(["text", "email", "url", "tel"]).nullable(),
+          placeholder: z.string().nullable(),
+          required: z.boolean().nullable(),
+          readOnly: z.boolean().nullable(),
+          helperText: z.string().nullable()
+        })
+      ),
+      notificationPreferences: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          description: z.string().nullable(),
+          enabled: z.boolean(),
+          disabled: z.boolean().nullable()
+        })
+      ),
+      avatar: z.object({
+        src: z.string().nullable(),
+        fallback: z.string().nullable(),
+        status: z.enum(["idle", "uploading", "error"]).nullable(),
+        errorMessage: z.string().nullable()
+      }).nullable(),
+      validationErrors: z.record(z.string(), z.string()).nullable(),
+      validationMessage: z.string().nullable(),
+      fatalErrorMessage: z.string().nullable()
+    }),
+    events: [
+      "sectionChange",
+      "fieldChange",
+      "notificationChange",
+      "save",
+      "discard",
+      "avatarUpload",
+      "avatarRemove"
+    ],
+    description: "Profile settings page with editable fields, notification preferences, avatar management, and save controls."
+  },
+  RecoveryPageKit: {
+    props: z.object({
+      mode: z.enum(["reset", "magic-link"]).nullable(),
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      buttonText: z.string().nullable(),
+      successTitle: z.string().nullable(),
+      errorMessage: z.string().nullable()
+    }),
+    events: ["submit", "backToLogin"],
+    description: "Full-page password recovery with email input and success confirmation."
+  },
+  ResetPageKit: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable()
+    }),
+    events: ["submit", "backToLogin"],
+    description: "Full-page password reset form with new password and confirmation fields."
+  },
+  ServiceSuitePageKit: {
+    props: z.object({
+      shell: marketingShellSchema,
+      variant: z.enum(["agency-home", "digital-workers", "service-detail"]).nullable(),
+      sectionOrder: z.array(
+        z.enum([
+          "hero",
+          "features",
+          "process",
+          "team",
+          "testimonials",
+          "faq",
+          "cta"
+        ])
+      ).nullable(),
+      hero: z.object({
+        headline: z.string().nullable(),
+        subheadline: z.string().nullable(),
+        primaryAction: z.object({ label: z.string() }).nullable()
+      }).nullable(),
+      features: z.object({
+        variant: z.enum(["grid", "list"]).nullable(),
+        badge: z.string().nullable(),
+        title: z.string().nullable(),
+        description: z.string().nullable(),
+        features: z.array(
+          z.object({
+            title: z.string(),
+            description: z.string(),
+            icon: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      process: z.object({
+        title: z.string().nullable(),
+        steps: z.array(
+          z.object({
+            title: z.string(),
+            description: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      team: z.object({ title: z.string().nullable() }).nullable(),
+      testimonials: z.object({
+        title: z.string().nullable(),
+        testimonials: z.array(
+          z.object({
+            quote: z.string(),
+            author: z.string(),
+            role: z.string(),
+            avatar: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      faq: z.object({
+        items: z.array(
+          z.object({
+            question: z.string(),
+            answer: z.string()
+          })
+        ).nullable()
+      }).nullable(),
+      cta: z.object({
+        title: z.string().nullable(),
+        primaryAction: z.object({ label: z.string(), href: z.string() }).nullable()
+      }).nullable()
+    }),
+    description: "Service-oriented landing page with hero, features, process flow, team, testimonials, FAQ, and CTA sections."
+  },
+  SettingsPageKit: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      sections: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          description: z.string().nullable(),
+          isAvailable: z.boolean().nullable(),
+          unavailableReason: z.string().nullable()
+        })
+      ),
+      activeSectionId: z.string(),
+      saveState: z.enum([
+        "default",
+        "dirty",
+        "saving",
+        "saved",
+        "validation-error",
+        "fatal-error",
+        "loading"
+      ]).nullable(),
+      validationMessage: z.string().nullable(),
+      fatalErrorMessage: z.string().nullable(),
+      savedMessage: z.string().nullable(),
+      saveLabel: z.string().nullable(),
+      discardLabel: z.string().nullable()
+    }),
+    events: ["sectionChange", "save", "discard"],
+    slots: ["sectionContent"],
+    description: "Settings page with sidebar section navigation, save/discard controls, and customizable section content."
+  },
+  SignupPageKit: {
+    props: z.object({
+      showSocial: z.boolean().nullable(),
+      signInHref: z.string().nullable(),
+      error: z.string().nullable()
+    }),
+    events: ["submit", "socialLogin"],
+    description: "Full-page sign-up experience with centered card, social login, and sign-in link."
+  },
+  SuccessPageKit: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      buttonText: z.string().nullable(),
+      autoRedirectSeconds: z.number().nullable()
+    }),
+    events: ["continue"],
+    description: "Success confirmation page with icon, message, continue button, and optional auto-redirect."
+  },
+  TeamSettingsPageKit: {
+    props: z.object({
+      shell: navigationShellSchema,
+      state: z.enum([
+        "loading",
+        "empty",
+        "filtered",
+        "invited-member",
+        "active-member",
+        "saving",
+        "fatal-error"
+      ]).nullable(),
+      members: z.array(
+        z.object({
+          id: z.string(),
+          name: z.string(),
+          email: z.string(),
+          role: z.enum(["owner", "admin", "member", "guest"]),
+          status: z.enum(["active", "invited", "suspended"]),
+          joinedLabel: z.string().nullable(),
+          avatarUrl: z.string().nullable()
+        })
+      ),
+      seatSummary: z.object({
+        usedSeats: z.number(),
+        totalSeats: z.number()
+      }),
+      search: z.object({
+        value: z.string(),
+        placeholder: z.string().nullable()
+      }),
+      inviteAction: z.object({
+        label: z.string(),
+        canInvite: z.boolean().nullable(),
+        disabledReason: z.string().nullable()
+      }),
+      memberActions: z.array(
+        z.object({
+          id: z.string(),
+          label: z.string(),
+          tone: z.enum(["default", "destructive"]).nullable()
+        })
+      ).nullable(),
+      selectedMemberId: z.string().nullable(),
+      errorMessage: z.string().nullable()
+    }),
+    events: [
+      "memberAction",
+      "selectedMemberChange",
+      "searchChange",
+      "invite"
+    ],
+    description: "Team management page with member table, seat summary, invite controls, and member actions."
+  },
+  TwoFactorPageKit: {
+    props: z.object({
+      mode: z.enum(["challenge", "setup"]).nullable(),
+      challenge: z.object({
+        error: z.string().nullable(),
+        title: z.string().nullable(),
+        description: z.string().nullable()
+      }).nullable(),
+      setup: z.object({
+        qrCodeUrl: z.string().nullable(),
+        secret: z.string().nullable(),
+        backupCodes: z.array(z.string()).nullable(),
+        title: z.string().nullable()
+      }).nullable()
+    }),
+    events: ["verify", "useBackupCode", "backToLogin", "setupComplete"],
+    description: "Two-factor authentication page with challenge (OTP entry) and setup (QR code + verification) modes."
+  },
+  VerifyEmailPageKit: {
+    props: z.object({
+      title: z.string().nullable(),
+      description: z.string().nullable(),
+      buttonText: z.string().nullable(),
+      autoRedirectSeconds: z.number().nullable()
+    }),
+    events: ["continue"],
+    description: "Email verification success page with icon, confirmation message, and continue action."
+  },
+  VoiceAgentsPageKit: {
+    props: z.object({
+      state: z.enum(["agent-selection", "active-conversation"]).nullable(),
+      agents: z.array(
+        z.object({
+          id: z.string(),
+          name: z.string(),
+          role: z.string(),
+          avatar: z.string(),
+          availability: z.enum(["online", "busy", "offline"]).nullable()
+        })
+      ),
+      selectedAgentId: z.string().nullable(),
+      presenceState: z.enum(["idle", "listening", "speaking"]).nullable(),
+      messages: z.array(
+        z.object({
+          id: z.string(),
+          role: z.enum(["user", "assistant", "agent", "system"]),
+          content: z.string(),
+          timestamp: z.string().nullable()
+        })
+      ).nullable(),
+      streamingReply: z.string().nullable(),
+      composerValue: z.string().nullable(),
+      composerPlaceholder: z.string().nullable(),
+      noAgentsMessage: z.string().nullable()
+    }),
+    events: [
+      "composerChange",
+      "sendMessage",
+      "selectAgent",
+      "backToSelection"
+    ],
+    description: "Voice agent interface with agent selection, conversation view, presence states, and real-time streaming."
+  }
+};
+
+export { seedComponentDefinitions, validateOnSchema, validationCheckSchema };