@rfdtech/components 1.21.0 → 2.0.0

package/dist/types/timeline.d.ts

@@ -0,0 +1,52 @@
+import type { HTMLAttributes, LiHTMLAttributes, OlHTMLAttributes, ReactNode } from "react";
+export type TimelineItemMode = "primary" | "success" | "warning" | "error" | "muted";
+export interface TimelineClassNames {
+    root?: string;
+}
+export interface TimelineProps extends Omit<OlHTMLAttributes<HTMLOListElement>, "className"> {
+    classNames?: TimelineClassNames;
+    className?: string;
+    children: ReactNode;
+}
+export interface TimelineItemClassNames {
+    root?: string;
+    rail?: string;
+    dot?: string;
+    connector?: string;
+    content?: string;
+}
+export interface TimelineItemProps extends Omit<LiHTMLAttributes<HTMLLIElement>, "className"> {
+    mode?: TimelineItemMode;
+    color?: string;
+    icon?: ReactNode;
+    classNames?: TimelineItemClassNames;
+    className?: string;
+    children?: ReactNode;
+    isLast?: boolean;
+}
+export interface TimelineTitleClassNames {
+    title?: string;
+}
+export interface TimelineTitleProps extends Omit<HTMLAttributes<HTMLHeadingElement>, "className"> {
+    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    classNames?: TimelineTitleClassNames;
+    className?: string;
+    children: ReactNode;
+}
+export interface TimelineDataClassNames {
+    data?: string;
+}
+export interface TimelineDataProps extends Omit<HTMLAttributes<HTMLParagraphElement>, "className"> {
+    classNames?: TimelineDataClassNames;
+    className?: string;
+    children: ReactNode;
+}
+export interface TimelineFooterClassNames {
+    footer?: string;
+}
+export interface TimelineFooterProps extends Omit<HTMLAttributes<HTMLDivElement>, "className"> {
+    classNames?: TimelineFooterClassNames;
+    className?: string;
+    children: ReactNode;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/dist/types/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/types/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CACzC,gBAAgB,CAAC,gBAAgB,CAAC,EAClC,WAAW,CACZ;IACC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,gBAAgB,CAAC,aAAa,CAAC,EAC/B,WAAW,CACZ;IACC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAC9C,cAAc,CAAC,kBAAkB,CAAC,EAClC,WAAW,CACZ;IACC,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,cAAc,CAAC,oBAAoB,CAAC,EACpC,WAAW,CACZ;IACC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,cAAc,CAAC,cAAc,CAAC,EAC9B,WAAW,CACZ;IACC,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB"}

package/dist/types/upload-field.d.ts

@@ -1,4 +1,12 @@
 import type { HTMLAttributes } from "react";
+export type UploadFieldFileStatusKind = "uploading" | "completed" | "failed";
+export interface UploadFieldFileStatus {
+    status: UploadFieldFileStatusKind;
+    /** 0–100, read when `status` is `"uploading"`. */
+    progress?: number;
+    /** Shown when `status` is `"failed"`; falls back to "Failed" when omitted. */
+    error?: string;
+}
 export interface UploadFieldClassNames {
     root?: string;
     icon?: string;
@@ -8,6 +16,11 @@ export interface UploadFieldClassNames {
     fileCard?: string;
     fileName?: string;
     fileSize?: string;
+    fileProgress?: string;
+    fileStatusText?: string;
+    retryButton?: string;
+    cancelButton?: string;
+    completedIcon?: string;
     removeButton?: string;
     actionButton?: string;
 }
@@ -21,5 +34,15 @@ export interface UploadFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, "
     value?: File | File[] | null;
     onChange?: (file: File | File[] | null) => void;
     name?: string;
+    /**
+     * Optional per-file status overlay — index-aligned with `value` (a single
+     * `File` value is treated as index 0). Omit entirely for the default plain
+     * attach/remove look with no uploading/completed/failed affordances.
+     */
+    fileStatuses?: UploadFieldFileStatus[];
+    /** Called when the cancel (×) control is clicked on a file with status `"uploading"`. */
+    onCancel?: (file: File, index: number) => void;
+    /** Called when "Try Again" is clicked on a file with status `"failed"`. */
+    onRetry?: (file: File, index: number) => void;
 }
 //# sourceMappingURL=upload-field.d.ts.map

package/dist/types/upload-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-field.d.ts","sourceRoot":"","sources":["../../src/types/upload-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACnH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"upload-field.d.ts","sourceRoot":"","sources":["../../src/types/upload-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,yBAAyB,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACnH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C"}

package/dist/utils/export.d.ts

@@ -0,0 +1,15 @@
+export interface ExportColumn<T> {
+    header: string;
+    accessor: (row: T) => string | number | null | undefined;
+}
+export interface ExportMeta {
+    title: string;
+    recordCount?: number;
+    filters?: string;
+    generatedAt?: string;
+}
+export declare function formatFilenameTimestamp(date: Date): string;
+export declare function exportToCsv<T>(data: T[], columns: ExportColumn<T>[], filename: string): void;
+export declare function exportToXlsx<T>(data: T[], columns: ExportColumn<T>[], filename: string): void;
+export declare function exportToPdf<T>(data: T[], columns: ExportColumn<T>[], filename: string, meta: ExportMeta): void;
+//# sourceMappingURL=export.d.ts.map

package/dist/utils/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/utils/export.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAaD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAG1D;AAoBD,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,QAAQ,EAAE,MAAM,QAgBjB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,QAAQ,EAAE,MAAM,QAsBjB;AAuFD,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,QA0BjB"}

package/dist/utils/stringToColor.d.ts

@@ -2,8 +2,33 @@
  * Deterministic hue from a string (0-360). Same string always produces the same hue.
  */
 export declare function stringToHue(str: string): number;
+/**
+ * Deterministic index into a fixed-size set of `count` items, derived from a
+ * string. Same string always produces the same index. Hashed separately from
+ * `stringToHue` (a distinguishing suffix is mixed in) so pattern selection
+ * doesn't visually correlate 1:1 with hue selection for the same string.
+ */
+export declare function patternIndexFromString(str: string, count: number): number;
 /**
  * Subtle pastel gradient from a string — pastel in light mode, richer in dark.
+ * Intended for a dark-text-on-light-background pairing (e.g. Avatar initials).
  */
 export declare function gradientFromString(str: string, theme?: string): string;
+/**
+ * Deterministic saturated gradient from a string, dark enough in both themes
+ * to carry white foreground content (e.g. an icon glyph or initials).
+ */
+export declare function vividGradientFromString(str: string, theme?: string): string;
+/**
+ * Deterministic index into a fixed-size set of `count` gradients, derived
+ * from a string. Same string always produces the same index.
+ */
+export declare function gradientIndexFromString(str: string, count: number): number;
+/**
+ * Deterministic index into a fixed-size set of `count` decorative overlays,
+ * derived from a string. Hashed separately from `gradientIndexFromString`
+ * (a distinguishing suffix is mixed in) so the overlay choice varies
+ * independently of the gradient choice for the same string.
+ */
+export declare function overlayIndexFromString(str: string, count: number): number;
 //# sourceMappingURL=stringToColor.d.ts.map

package/dist/utils/stringToColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stringToColor.d.ts","sourceRoot":"","sources":["../../src/utils/stringToColor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUtE"}
+{"version":3,"file":"stringToColor.d.ts","sourceRoot":"","sources":["../../src/utils/stringToColor.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rfdtech/components",
-  "version": "1.21.0",
-  "description": "Shared React component library for Ghana School of Law (GSL) projects",
+  "version": "2.0.0",
+  "description": "Shared React component library for Clet projects",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -30,22 +30,42 @@
       "import": "./dist/index.css",
       "require": "./dist/index.css",
       "default": "./dist/index.css"
+    },
+    "./next": {
+      "import": {
+        "types": "./dist/next-index.d.ts",
+        "default": "./dist/next.js"
+      },
+      "require": {
+        "types": "./dist/next-index.d.ts",
+        "default": "./dist/next.cjs"
+      }
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "scripts/postinstall.mjs"
   ],
+  "bin": {
+    "components-mcp": "dist/mcp/index.js",
+    "rfdui": "dist/mcp/cli.js"
+  },
   "scripts": {
-    "build": "vite build && tsc -p tsconfig.build.json",
+    "prepare": "npm run generate:tokens",
+    "postinstall": "node scripts/postinstall.mjs",
+    "generate:tokens": "node scripts/generate-theme-tokens.mjs",
+    "build": "npm run generate:tokens && BUILD_TARGET=default npx vite build && BUILD_TARGET=next npx vite build && mv dist/next-index.css dist/next.css && node -e \"var fs=require('fs');['dist/next.js','dist/next.cjs'].forEach(f=>fs.writeFileSync(f,fs.readFileSync(f,'utf8').replace('./next-index.css','./next.css')))\" && tsc -p tsconfig.build.json && cp src/next.d.ts dist/next.d.ts && (cd mcp && npx tsc -p tsconfig.json) && node mcp/scripts/prepare-dist.mjs",
+    "build:mcp": "(cd mcp && npx tsc -p tsconfig.json) && node mcp/scripts/prepare-dist.mjs",
     "dev": "vite-react-ssg dev -c vite.demo.config.ts",
     "demo": "vite-react-ssg build -c vite.demo.config.ts",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:types": "vitest --typecheck run",
     "lint": "eslint .",
     "lint:css": "stylelint 'src/**/*.css' --max-warnings 0",
     "lint:css:fix": "stylelint 'src/**/*.css' --fix",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run lint:css && npm run lint && npm run typecheck && npm run test && npm run build"
+    "prepublishOnly": "npm run generate:tokens && npm run lint:css && npm run lint && npm run typecheck && npm run test && npm run test:types && npm run build"
   },
   "peerDependencies": {
     "@hookform/resolvers": ">=3.0.0",
@@ -55,12 +75,15 @@
     "@radix-ui/react-popover": "^1.1.0",
     "@radix-ui/react-radio-group": "^1.4.0",
     "@radix-ui/react-select": "^2.3.0",
+    "@radix-ui/react-switch": "^1.2.0",
     "@radix-ui/react-tabs": "^1.1.0",
     "lucide-react": ">=1.0.0",
+    "next": ">=14.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "react-hook-form": ">=7.0.0",
     "react-router-dom": ">=7.0.0",
+    "xlsx": ">=0.18.5",
     "zod": ">=3.0.0"
   },
   "peerDependenciesMeta": {
@@ -70,8 +93,14 @@
     "zod": {
       "optional": true
     },
+    "next": {
+      "optional": true
+    },
     "@hookform/resolvers": {
       "optional": true
+    },
+    "xlsx": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -87,6 +116,7 @@
     "@radix-ui/react-popover": "^1.1.16",
     "@radix-ui/react-radio-group": "^1.4.0",
     "@radix-ui/react-select": "^2.3.0",
+    "@radix-ui/react-switch": "^1.3.3",
     "@radix-ui/react-tabs": "^1.1.14",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
@@ -95,6 +125,7 @@
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "@vitejs/plugin-react": "^5.0.0",
+    "@vitest/coverage-v8": "^4.1.10",
     "eslint": "^10.5.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "jsdom": "^29.1.1",
@@ -115,13 +146,14 @@
     "vite-plugin-lib-inject-css": "^2.2.2",
     "vite-react-ssg": "^0.9.1-beta.1",
     "vitest": "^4.1.8",
+    "xlsx": "^0.18.5",
     "zod": "^4.4.3"
   },
   "keywords": [
     "react",
     "components",
     "gsl",
-    "ghana-school-of-law",
+    "clet",
     "app-switcher",
     "app-launcher",
     "google-apps",
@@ -135,11 +167,15 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@fontsource/lato": "^5.2.7",
+    "@fontsource/roboto-serif": "^5.2.9",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@tanstack/react-virtual": "^3.14.3",
     "cmdk": "^1.1.1",
+    "country-flag-icons": "^1.6.20",
     "libphonenumber-js": "^1.13.7",
     "lottie-react": "^2.4.1",
     "sonner": "^2.0.7",
-    "xlsx": "^0.18.5"
+    "zod": ">=3.0.0"
   }
 }

package/scripts/postinstall.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// Auto-wires AI coding tools (Claude Code, Cursor, Codex, OpenCode) with the
+// @rfdtech/components MCP server + skill doc, so `npm install` alone is
+// enough to get MCP-aware, real-component-first UI generation — no manual
+// `npx rfdui setup` step required. Set RFDUI_SKIP_SETUP to skip (e.g. in CI).
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const skip = process.env.RFDUI_SKIP_SETUP;
+if (skip && skip !== "0" && skip.toLowerCase() !== "false") {
+  process.exit(0);
+}
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const cliPath = path.join(__dirname, "..", "dist", "mcp", "cli.js");
+
+// Unbuilt checkout (e.g. a contributor's `npm install` before `npm run
+// build` has produced dist/) — nothing to run yet, and that's fine.
+if (!existsSync(cliPath)) {
+  process.exit(0);
+}
+
+// npm sets INIT_CWD to the directory the top-level `npm install` was run
+// from. process.cwd() during a dependency's postinstall is the package's
+// own folder inside node_modules — the wrong place to write .claude/,
+// .cursor/, etc. Always target the consumer's actual project root.
+const targetDir = process.env.INIT_CWD || process.cwd();
+
+try {
+  spawnSync(process.execPath, [cliPath, "setup"], {
+    cwd: targetDir,
+    stdio: "inherit",
+  });
+} catch {
+  // Never fail `npm install` over optional AI-tool setup.
+}
+
+process.exit(0);