ai-design-system 0.1.0

package/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/package.json

@@ -0,0 +1,140 @@
+{
+  "name": "ai-design-system",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "AI-powered design system with React components, built with Tailwind CSS and Radix UI",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./styles": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "components",
+    "lib",
+    "hooks",
+    "utils",
+    "tokens",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bizmatters/ai-design-system.git"
+  },
+  "keywords": [
+    "react",
+    "components",
+    "design-system",
+    "ui",
+    "tailwind",
+    "radix-ui",
+    "ai",
+    "typescript"
+  ],
+  "author": "Bizmatters",
+  "license": "MIT",
+  "dependencies": {
+    "@radix-ui/react-accordion": "^1.2.12",
+    "@radix-ui/react-alert-dialog": "^1.1.15",
+    "@radix-ui/react-avatar": "^1.1.11",
+    "@radix-ui/react-checkbox": "^1.3.3",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-hover-card": "^1.1.15",
+    "@radix-ui/react-label": "^2.1.8",
+    "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-progress": "^1.1.8",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-separator": "^1.1.8",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-toggle": "^1.1.10",
+    "@radix-ui/react-toggle-group": "^1.1.11",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@radix-ui/react-use-controllable-state": "^1.2.2",
+    "@tanstack/react-table": "^8.21.3",
+    "@tiptap/core": "^3.10.7",
+    "@tiptap/extension-highlight": "^3.10.7",
+    "@tiptap/markdown": "^3.10.7",
+    "@tiptap/react": "^3.10.7",
+    "@tiptap/starter-kit": "^3.10.7",
+    "@xyflow/react": "^12.9.2",
+    "ai": "^5.0.87",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.1.0",
+    "embla-carousel-react": "^8.6.0",
+    "lucide-react": "^0.552.0",
+    "motion": "^12.23.24",
+    "nanoid": "^5.1.6",
+    "next": "16.0.1",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "recharts": "^3.4.1",
+    "shiki": "^3.14.0",
+    "streamdown": "^1.4.0",
+    "tailwind-merge": "^3.3.1",
+    "tokenlens": "^1.3.1",
+    "use-stick-to-bottom": "^1.1.1",
+    "vaul": "^1.1.2"
+  },
+  "devDependencies": {
+    "@chromatic-com/storybook": "^4.1.2",
+    "@storybook/addon-a11y": "^10.0.4",
+    "@storybook/addon-docs": "^10.0.4",
+    "@storybook/addon-onboarding": "^10.0.4",
+    "@storybook/addon-vitest": "^10.0.4",
+    "@storybook/nextjs-vite": "^10.0.4",
+    "@storybook/test": "^8.6.14",
+    "@tailwindcss/postcss": "^4.1.16",
+    "@types/hast": "^3.0.4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitest/browser-playwright": "^4.0.7",
+    "@vitest/coverage-v8": "^4.0.7",
+    "eslint": "^9",
+    "eslint-config-next": "16.0.1",
+    "eslint-plugin-storybook": "^10.0.4",
+    "hast": "^1.0.0",
+    "ignore-loader": "^0.1.2",
+    "playwright": "^1.56.1",
+    "storybook": "^10.0.4",
+    "style-dictionary": "^5.1.1",
+    "tailwindcss": "^4.1.16",
+    "tsup": "^8.3.5",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5",
+    "vitest": "^4.0.7"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "next": "^14.0.0 || ^15.0.0 || ^16.0.0"
+  },
+  "scripts": {
+    "dev": "pnpm tokens:build && next dev",
+    "build": "pnpm tokens:build && pnpm prebuild && next build",
+    "build:lib": "pnpm tokens:build && tsup",
+    "prebuild": "bash scripts/run-all-validations.sh",
+    "start": "next start",
+    "lint": "eslint",
+    "tokens:build": "node build-tokens.js",
+    "tokens:watch": "style-dictionary build --watch",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
+  }
+}

package/tokens/color/base.json

@@ -0,0 +1,14 @@
+{
+  "color": {
+    "base": {
+      "white": {
+        "$value": "oklch(1 0 0)",
+        "$type": "color"
+      },
+      "black": {
+        "$value": "oklch(0.145 0 0)",
+        "$type": "color"
+      }
+    }
+  }
+}

package/tokens/color/dark.json

@@ -0,0 +1,40 @@
+{
+  "color": {
+    "theme": {
+      "background": { "$value": "oklch(0.145 0 0)", "$type": "color" },
+      "foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "card": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "card-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "popover": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "popover-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "secondary": { "$value": "oklch(0.269 0 0)", "$type": "color" },
+      "secondary-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "muted": { "$value": "oklch(0.269 0 0)", "$type": "color" },
+      "muted-foreground": { "$value": "oklch(0.708 0 0)", "$type": "color" },
+      "accent": { "$value": "oklch(0.269 0 0)", "$type": "color" },
+      "accent-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "destructive": { "$value": "oklch(0.704 0.191 22.216)", "$type": "color" },
+      "border": { "$value": "oklch(1 0 0 / 10%)", "$type": "color" },
+      "input": { "$value": "oklch(1 0 0 / 15%)", "$type": "color" }
+    },
+    "sidebar": {
+      "background": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "accent": { "$value": "oklch(0.269 0 0)", "$type": "color" },
+      "accent-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "border": { "$value": "oklch(1 0 0 / 10%)", "$type": "color" }
+    },
+    "annotation": {
+      "comment": { "$value": "oklch(0.35 0.12 95)", "$type": "color" },
+      "comment-foreground": { "$value": "oklch(0.85 0.12 95)", "$type": "color" },
+      "comment-border": { "$value": "oklch(0.55 0.15 95)", "$type": "color" },
+      "addition": { "$value": "oklch(0.30 0.12 145)", "$type": "color" },
+      "addition-foreground": { "$value": "oklch(0.75 0.12 145)", "$type": "color" },
+      "addition-border": { "$value": "oklch(0.50 0.15 145)", "$type": "color" },
+      "deletion": { "$value": "oklch(0.35 0.12 25)", "$type": "color" },
+      "deletion-foreground": { "$value": "oklch(0.75 0.15 25)", "$type": "color" },
+      "deletion-border": { "$value": "oklch(0.50 0.17 25)", "$type": "color" }
+    }
+  }
+}

package/tokens/color/green.json

@@ -0,0 +1,21 @@
+{
+  "color": {
+    "theme": {
+      "primary": { "$value": "oklch(0.648 0.2 131.684)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.986 0.031 120.757)", "$type": "color" },
+      "ring": { "$value": "oklch(0.405 0.101 131.063)", "$type": "color" }
+    },
+    "chart": {
+      "1": { "$value": "oklch(0.871 0.15 154.449)", "$type": "color" },
+      "2": { "$value": "oklch(0.723 0.219 149.579)", "$type": "color" },
+      "3": { "$value": "oklch(0.627 0.194 149.214)", "$type": "color" },
+      "4": { "$value": "oklch(0.527 0.154 150.069)", "$type": "color" },
+      "5": { "$value": "oklch(0.448 0.119 151.328)", "$type": "color" }
+    },
+    "sidebar": {
+      "primary": { "$value": "oklch(0.768 0.233 130.85)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.986 0.031 120.757)", "$type": "color" },
+      "ring": { "$value": "oklch(0.405 0.101 131.063)", "$type": "color" }
+    }
+  }
+}

package/tokens/color/light.json

@@ -0,0 +1,52 @@
+{
+  "color": {
+    "theme": {
+      "background": { "$value": "{color.base.white}", "$type": "color" },
+      "foreground": { "$value": "{color.base.black}", "$type": "color" },
+      "card": { "$value": "{color.base.white}", "$type": "color" },
+      "card-foreground": { "$value": "{color.base.black}", "$type": "color" },
+      "popover": { "$value": "{color.base.white}", "$type": "color" },
+      "popover-foreground": { "$value": "{color.base.black}", "$type": "color" },
+      "primary": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "secondary": { "$value": "oklch(0.97 0 0)", "$type": "color" },
+      "secondary-foreground": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "muted": { "$value": "oklch(0.97 0 0)", "$type": "color" },
+      "muted-foreground": { "$value": "oklch(0.556 0 0)", "$type": "color" },
+      "accent": { "$value": "oklch(0.97 0 0)", "$type": "color" },
+      "accent-foreground": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "destructive": { "$value": "oklch(0.577 0.245 27.325)", "$type": "color" },
+      "border": { "$value": "oklch(0.922 0 0)", "$type": "color" },
+      "input": { "$value": "oklch(0.922 0 0)", "$type": "color" },
+      "ring": { "$value": "oklch(0.708 0 0)", "$type": "color" }
+    },
+    "chart": {
+      "1": { "$value": "oklch(0.646 0.222 41.116)", "$type": "color" },
+      "2": { "$value": "oklch(0.6 0.118 184.704)", "$type": "color" },
+      "3": { "$value": "oklch(0.398 0.07 227.392)", "$type": "color" },
+      "4": { "$value": "oklch(0.828 0.189 84.429)", "$type": "color" },
+      "5": { "$value": "oklch(0.769 0.188 70.08)", "$type": "color" }
+    },
+    "sidebar": {
+      "background": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "foreground": { "$value": "{color.base.black}", "$type": "color" },
+      "primary": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.985 0 0)", "$type": "color" },
+      "accent": { "$value": "oklch(0.97 0 0)", "$type": "color" },
+      "accent-foreground": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "border": { "$value": "oklch(0.922 0 0)", "$type": "color" },
+      "ring": { "$value": "oklch(0.708 0 0)", "$type": "color" }
+    },
+    "annotation": {
+      "comment": { "$value": "oklch(0.95 0.15 95)", "$type": "color" },
+      "comment-foreground": { "$value": "oklch(0.45 0.15 95)", "$type": "color" },
+      "comment-border": { "$value": "oklch(0.65 0.18 95)", "$type": "color" },
+      "addition": { "$value": "oklch(0.85 0.15 145)", "$type": "color" },
+      "addition-foreground": { "$value": "oklch(0.35 0.15 145)", "$type": "color" },
+      "addition-border": { "$value": "oklch(0.55 0.18 145)", "$type": "color" },
+      "deletion": { "$value": "oklch(0.88 0.15 25)", "$type": "color" },
+      "deletion-foreground": { "$value": "oklch(0.45 0.18 25)", "$type": "color" },
+      "deletion-border": { "$value": "oklch(0.58 0.20 25)", "$type": "color" }
+    }
+  }
+}

package/tokens/color/neutral.json

@@ -0,0 +1,20 @@
+{
+  "color": {
+    "theme": {
+      "primary": { "$value": "oklch(0.922 0 0)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.205 0 0)", "$type": "color" },
+      "ring": { "$value": "oklch(0.556 0 0)", "$type": "color" }
+    },
+    "chart": {
+      "1": { "$value": "oklch(0.488 0.243 264.376)", "$type": "color" },
+      "2": { "$value": "oklch(0.696 0.17 162.48)", "$type": "color" },
+      "3": { "$value": "oklch(0.769 0.188 70.08)", "$type": "color" },
+      "4": { "$value": "oklch(0.627 0.265 303.9)", "$type": "color" },
+      "5": { "$value": "oklch(0.645 0.246 16.439)", "$type": "color" }
+    },
+    "sidebar": {
+      "primary": { "$value": "oklch(0.488 0.243 264.376)", "$type": "color" },
+      "ring": { "$value": "oklch(0.556 0 0)", "$type": "color" }
+    }
+  }
+}

package/tokens/color/violet.json

@@ -0,0 +1,21 @@
+{
+  "color": {
+    "theme": {
+      "primary": { "$value": "oklch(0.606 0.25 292.717)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.969 0.016 293.756)", "$type": "color" },
+      "ring": { "$value": "oklch(0.38 0.189 293.745)", "$type": "color" }
+    },
+    "chart": {
+      "1": { "$value": "oklch(0.811 0.111 293.571)", "$type": "color" },
+      "2": { "$value": "oklch(0.606 0.25 292.717)", "$type": "color" },
+      "3": { "$value": "oklch(0.541 0.281 293.009)", "$type": "color" },
+      "4": { "$value": "oklch(0.491 0.27 292.581)", "$type": "color" },
+      "5": { "$value": "oklch(0.432 0.232 292.759)", "$type": "color" }
+    },
+    "sidebar": {
+      "primary": { "$value": "oklch(0.606 0.25 292.717)", "$type": "color" },
+      "primary-foreground": { "$value": "oklch(0.969 0.016 293.756)", "$type": "color" },
+      "ring": { "$value": "oklch(0.38 0.189 293.745)", "$type": "color" }
+    }
+  }
+}

package/tokens/spacing.json

@@ -0,0 +1,22 @@
+{
+  "spacing": {
+    "radius": {
+      "$type": "dimension",
+      "base": { "$value": "0.625rem" },
+      "sm": { "$value": "{spacing.radius.base} - 4px" },
+      "md": { "$value": "{spacing.radius.base} - 2px" },
+      "lg": { "$value": "{spacing.radius.base}" },
+      "xl": { "$value": "{spacing.radius.base} + 4px" }
+    },
+    "sidebar": {
+      "$type": "dimension",
+      "width": { "$value": "16rem" },
+      "width-mobile": { "$value": "18rem" },
+      "width-icon": { "$value": "3rem" }
+    },
+    "header": {
+      "$type": "dimension",
+      "height": { "$value": "3.5rem" }
+    }
+  }
+}

package/utils/ai-editor/format-date.ts

@@ -0,0 +1,41 @@
+/**
+ * Format Comment Date Utility
+ * 
+ * Formats timestamps as relative time for comment display
+ */
+
+import { formatDistanceToNow } from 'date-fns'
+
+/**
+ * Formats a timestamp as relative time
+ * 
+ * @param date - Date object or Unix timestamp (number) to format
+ * @returns Formatted string like "5m", "2h", "3d", "2w", "3mo", "1y"
+ * 
+ * @example
+ * ```ts
+ * formatCommentDate(new Date(Date.now() - 5 * 60 * 1000)) // "5m"
+ * formatCommentDate(Date.now() - 2 * 60 * 60 * 1000) // "2h"
+ * ```
+ */
+export function formatCommentDate(date: Date | number): string {
+  const now = Date.now()
+  const timestamp = typeof date === 'number' ? date : date.getTime()
+  const diffMs = now - timestamp
+
+  const seconds = Math.floor(diffMs / 1000)
+  const minutes = Math.floor(seconds / 60)
+  const hours = Math.floor(minutes / 60)
+  const days = Math.floor(hours / 24)
+  const weeks = Math.floor(days / 7)
+  const months = Math.floor(days / 30)
+  const years = Math.floor(days / 365)
+
+  if (seconds < 60) return 'just now'
+  if (minutes < 60) return `${minutes}m`
+  if (hours < 24) return `${hours}h`
+  if (days < 7) return `${days}d`
+  if (weeks < 4) return `${weeks}w`
+  if (months < 12) return `${months}mo`
+  return `${years}y`
+}

package/utils/ai-editor/index.ts

@@ -0,0 +1,22 @@
+/**
+ * AI Editor Utilities
+ * 
+ * Central export point for all AI Editor utility functions
+ */
+
+// Type guards
+export {
+  isCommentAnnotation,
+  isSuggestionAnnotation,
+  isBlockAdditionAnnotation,
+} from './type-guards'
+
+// Validation utilities
+export {
+  validateRange,
+  validateAnnotation,
+  validateAnnotations,
+} from './validation'
+
+// Date formatting
+export { formatCommentDate } from './format-date'

package/utils/ai-editor/type-guards.ts

@@ -0,0 +1,72 @@
+/**
+ * Type Guards for AI Editor Annotations
+ * 
+ * Provides runtime type checking for discriminated union types
+ */
+
+import type {
+  Annotation,
+  CommentAnnotation,
+  SuggestionAnnotation,
+  BlockAdditionAnnotation,
+} from '../../types/ai-editor'
+
+/**
+ * Type guard to check if annotation is a CommentAnnotation
+ * 
+ * @param annotation - Annotation to check
+ * @returns True if annotation is a CommentAnnotation
+ * 
+ * @example
+ * ```ts
+ * if (isCommentAnnotation(annotation)) {
+ *   // TypeScript knows annotation.data.thread exists
+ *   console.log(annotation.data.thread.length)
+ * }
+ * ```
+ */
+export function isCommentAnnotation(
+  annotation: Annotation
+): annotation is CommentAnnotation {
+  return annotation.type === 'comment'
+}
+
+/**
+ * Type guard to check if annotation is a SuggestionAnnotation
+ * 
+ * @param annotation - Annotation to check
+ * @returns True if annotation is a SuggestionAnnotation
+ * 
+ * @example
+ * ```ts
+ * if (isSuggestionAnnotation(annotation)) {
+ *   // TypeScript knows annotation.data.action exists
+ *   console.log(annotation.data.action)
+ * }
+ * ```
+ */
+export function isSuggestionAnnotation(
+  annotation: Annotation
+): annotation is SuggestionAnnotation {
+  return annotation.type === 'suggestion'
+}
+
+/**
+ * Type guard to check if annotation is a BlockAdditionAnnotation
+ * 
+ * @param annotation - Annotation to check
+ * @returns True if annotation is a BlockAdditionAnnotation
+ * 
+ * @example
+ * ```ts
+ * if (isBlockAdditionAnnotation(annotation)) {
+ *   // TypeScript knows annotation.data.content exists
+ *   console.log(annotation.data.content)
+ * }
+ * ```
+ */
+export function isBlockAdditionAnnotation(
+  annotation: Annotation
+): annotation is BlockAdditionAnnotation {
+  return annotation.type === 'block-addition'
+}

package/utils/ai-editor/validation.ts

@@ -0,0 +1,130 @@
+/**
+ * Validation Utilities for AI Editor
+ * 
+ * Provides runtime validation for annotations and ranges
+ */
+
+import type { Annotation, Range } from '../../types/ai-editor'
+import {
+  isCommentAnnotation,
+  isSuggestionAnnotation,
+  isBlockAdditionAnnotation,
+} from './type-guards'
+
+/**
+ * Validates a range object
+ * 
+ * @param range - Range to validate
+ * @param documentLength - Total length of the document
+ * @returns True if range is valid
+ */
+export function validateRange(range: Range, documentLength: number): boolean {
+  // Check range bounds
+  if (range.from < 0 || range.to > documentLength) {
+    console.error('Range out of bounds:', range, 'Document length:', documentLength)
+    return false
+  }
+
+  // Check range order
+  if (range.from >= range.to) {
+    console.error('Invalid range: from must be less than to:', range)
+    return false
+  }
+
+  return true
+}
+
+/**
+ * Validates an annotation object
+ * 
+ * @param annotation - Annotation to validate
+ * @param documentLength - Total length of the document
+ * @returns True if annotation is valid
+ */
+export function validateAnnotation(
+  annotation: Annotation,
+  documentLength: number
+): boolean {
+  // Validate range
+  if (!validateRange(annotation.range, documentLength)) {
+    return false
+  }
+
+  // Validate type-specific data
+  if (isCommentAnnotation(annotation)) {
+    if (!annotation.data.thread || annotation.data.thread.length === 0) {
+      console.error('Comment annotation must have at least one comment:', annotation)
+      return false
+    }
+  } else if (isSuggestionAnnotation(annotation)) {
+    if (!annotation.data.reason) {
+      console.error('Suggestion annotation must have a reason:', annotation)
+      return false
+    }
+
+    // Validate action-specific requirements
+    if (annotation.data.action === 'modify') {
+      if (!annotation.data.oldText || !annotation.data.newText) {
+        console.error(
+          'Modify suggestion must have both oldText and newText:',
+          annotation
+        )
+        return false
+      }
+    } else if (annotation.data.action === 'delete') {
+      if (!annotation.data.oldText) {
+        console.error('Delete suggestion must have oldText:', annotation)
+        return false
+      }
+    } else if (annotation.data.action === 'insert') {
+      if (!annotation.data.newText) {
+        console.error('Insert suggestion must have newText:', annotation)
+        return false
+      }
+    }
+  } else if (isBlockAdditionAnnotation(annotation)) {
+    if (!annotation.data.content || !annotation.data.reason) {
+      console.error('Block addition must have content and reason:', annotation)
+      return false
+    }
+  }
+
+  return true
+}
+
+/**
+ * Validates an array of annotations
+ * 
+ * @param annotations - Array of annotations to validate
+ * @param documentLength - Total length of the document
+ * @returns Object with validation results
+ */
+export function validateAnnotations(
+  annotations: Annotation[],
+  documentLength: number
+): {
+  valid: boolean
+  errors: string[]
+  validAnnotations: Annotation[]
+  invalidAnnotations: Annotation[]
+} {
+  const errors: string[] = []
+  const validAnnotations: Annotation[] = []
+  const invalidAnnotations: Annotation[] = []
+
+  for (const annotation of annotations) {
+    if (validateAnnotation(annotation, documentLength)) {
+      validAnnotations.push(annotation)
+    } else {
+      invalidAnnotations.push(annotation)
+      errors.push(`Invalid annotation: ${annotation.id}`)
+    }
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+    validAnnotations,
+    invalidAnnotations,
+  }
+}