fix(react-doctor): clear architecture structure warnings

apps/registry/lib/jsonld.ts

@@ -51,24 +51,6 @@ export function softwareSourceCodeLd(component: {
   };
 }
 
-export function itemListLd(items: ReadonlyArray<{
-  readonly name: string;
-  readonly title: string;
-}>): JsonLdNode {
-  return {
-    "@context": "https://schema.org",
-    "@type": "ItemList",
-    name: "VLLNT UI Components",
-    numberOfItems: items.length,
-    itemListElement: items.map((item, index) => ({
-      "@type": "ListItem",
-      position: index + 1,
-      name: item.title,
-      url: `${SITE_URL}/components/${item.name}`,
-    })),
-  };
-}
-
 export function breadcrumbLd(trail: ReadonlyArray<{
   readonly name: string;
   readonly url: string;

apps/registry/lib/og-templates.ts

@@ -10,7 +10,7 @@ const DESCRIPTION_MAX = 120;
 const TITLE_MAX_LARGE = 25;
 const TITLE_MAX_SMALL = 30;
 
-export const OG_TEMPLATES = {
+const OG_TEMPLATES = {
   component: {
     descriptionMaxLength: DESCRIPTION_MAX,
     footerLabel: "COMPONENT",

apps/registry/lib/og.ts

@@ -6,7 +6,7 @@ export const OG_IMAGE_HEIGHT = 1260;
 
 const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL ?? "https://ui.vllnt.ai";
 
-export const ogImageParametersSchema = z.object({
+const ogImageParametersSchema = z.object({
   category: z.string().max(100).optional(),
   description: z.string().max(500).optional(),
   title: z.string().min(1).max(200).default("VLLNT UI"),
@@ -15,9 +15,8 @@ export const ogImageParametersSchema = z.object({
 });
 
 export type OGImageParametersInput = z.input<typeof ogImageParametersSchema>;
-export type OGImageParameters = z.infer<typeof ogImageParametersSchema>;
 
-export function generateOGImageURL(parameters: OGImageParametersInput): string {
+function generateOGImageURL(parameters: OGImageParametersInput): string {
   const validated = ogImageParametersSchema.parse(parameters);
 
   const searchParameters = new URLSearchParams({

apps/registry/lib/schemas.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-export const ogImageFrontmatterSchema = z.object({
+const ogImageFrontmatterSchema = z.object({
   category: z.string().optional(),
   description: z.string().optional(),
   title: z.string().optional(),
@@ -15,4 +15,3 @@ export const pageFrontmatterSchema = z.object({
 });
 
 export type PageFrontmatter = z.infer<typeof pageFrontmatterSchema>;
-export type OGImageFrontmatter = z.infer<typeof ogImageFrontmatterSchema>;

apps/registry/lib/stats.ts

@@ -27,12 +27,12 @@ export function getRegistryGeneratedAt(): string | undefined {
   return REGISTRY.generatedAt;
 }
 
-export type CategoryStat = {
+type CategoryStat = {
   readonly category: string;
   readonly count: number;
 };
 
-export function getCategoryStats(): readonly CategoryStat[] {
+function getCategoryStats(): readonly CategoryStat[] {
   const counts = new Map<string, number>();
   for (const item of REGISTRY.items) {
     const key = item.category ?? "uncategorized";

apps/registry/registry/default/blog-card/blog-card.tsx

@@ -90,5 +90,6 @@ export function ContentCard({
   );
 }
 
-// Keep BlogCard as an alias for backward compatibility
-export const BlogCard = ContentCard;
+export function BlogCard(props: ContentCardProps) {
+  return <ContentCard {...props} />;
+}

apps/registry/types/registry.ts

@@ -1,4 +1,4 @@
-export type RegistryFile = {
+type RegistryFile = {
   path: string;
   type: string;
 };
@@ -13,30 +13,30 @@ export type ComponentCategory =
   | "overlay"
   | "utility";
 
-export type Stability = "stable" | "beta" | "experimental" | "deprecated";
+type Stability = "stable" | "beta" | "experimental" | "deprecated";
 
-export type A11yKeyboardBinding = {
+type A11yKeyboardBinding = {
   keys: string;
   action: string;
 };
 
-export type A11ySchema = {
+type A11ySchema = {
   role?: string;
   keyboard?: A11yKeyboardBinding[];
   aria?: string[];
   focusManagement?: "auto" | "manual";
   notes?: string;
 };
 
-export type UsageExample = {
+type UsageExample = {
   title: string;
   description?: string;
   code: string;
   framework?: "react" | "next";
   storyId?: string;
 };
 
-export type PropDefinition = {
+type PropDefinition = {
   name: string;
   type: string;
   required?: boolean;
@@ -62,7 +62,7 @@ export type RegistryComponent = {
   version?: string;
 };
 
-export type RegistryItem = RegistryComponent;
+type RegistryItem = RegistryComponent;
 
 export type Registry = {
   $schema?: string;

knip.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://unpkg.com/knip@5/schema.json",
+  "workspaces": {
+    "apps/registry": {
+      "ignore": [
+        "components/component-preview/component-preview.tsx",
+        "content/pages/**",
+        "lib/utils.ts",
+        "registry.ts",
+        "registry/default/**",
+        "styles.css",
+        "themes/default.css"
+      ]
+    },
+    "packages/ui": {
+      "ignore": [
+        ".storybook/next-stubs.ts",
+        ".storybook/next-themes-stub.ts",
+        "styles.dev.css"
+      ]
+    }
+  }
+}

packages/ui/src/components/blog-card/blog-card.test.tsx

@@ -85,7 +85,9 @@ describe("ContentCard", () => {
 });
 
 describe("BlogCard", () => {
-  it("is the same component as ContentCard", () => {
-    expect(BlogCard).toBe(ContentCard);
+  it("renders through the backwards-compatible alias", () => {
+    render(<BlogCard href="/posts/first-post" post={post} />);
+
+    expect(screen.getByText("First post")).toBeInTheDocument();
   });
 });

packages/ui/src/components/blog-card/blog-card.tsx

@@ -90,5 +90,6 @@ export function ContentCard({
   );
 }
 
-// Keep BlogCard as an alias for backward compatibility
-export const BlogCard = ContentCard;
+export function BlogCard(props: ContentCardProps) {
+  return <ContentCard {...props} />;
+}