base-themes 0.1.2 → 0.1.3

package/package.json

@@ -1,8 +1,26 @@
 {
   "name": "base-themes",
   "private": false,
-  "version": "0.1.2",
-  "description": "Themeable Base UI React components with Bento, shadcn, neo brutalism, and expressive product UI styles.",
+  "version": "0.1.3",
+  "description": "Accessible Base UI React components with 20 themes, registry metadata, and agent-friendly workflows.",
+  "keywords": [
+    "base-ui",
+    "base-ui-theme",
+    "react-components",
+    "react-ui",
+    "component-library",
+    "themes",
+    "css-variables",
+    "design-tokens",
+    "design-system",
+    "shadcn",
+    "shadcn-ui",
+    "registry",
+    "copy-paste",
+    "agent-friendly",
+    "typescript",
+    "accessibility"
+  ],
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -12,7 +30,10 @@
   "bugs": {
     "url": "https://github.com/markbang/base-themes/issues"
   },
-  "homepage": "https://github.com/markbang/base-themes#readme",
+  "homepage": "https://base-themes.bangwu.me",
+  "publishConfig": {
+    "access": "public"
+  },
   "sideEffects": [
     "**/*.css"
   ],
@@ -20,10 +41,83 @@
     "dist/base-themes.js",
     "dist/base-themes.css",
     "dist/types",
+    "src/components/ui",
+    "!src/components/ui/*.test.tsx",
+    "!src/components/ui/*.test.ts",
+    "src/blocks",
+    "src/docs/blockMeta.json",
+    "src/docs/componentMeta.json",
+    "src/docs/staticPageMeta.json",
+    "src/docs/themeMeta.json",
+    "src/styles/tokenContract.json",
     "public/previews",
     "registry",
+    "llms-full.txt",
+    "llms.txt",
     "skills/base-themes/SKILL.md",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "CODE_OF_CONDUCT.md",
+    "CONTRIBUTING.md",
+    "RELEASE.md",
+    "SECURITY.md",
+    "LICENSE",
+    "docs/adoption-dashboard.md",
+    "docs/analytics-setup.md",
+    "docs/community-gallery-proposal.md",
+    "docs/community-proof-telemetry.md",
+    "docs/contributor-issue-seeds.md",
+    "docs/release-announcement-kit.md",
+    "docs/registry-access-telemetry.md",
+    "docs/search-console-setup.md",
+    "docs/theme-token-contract.md",
+    "research/telemetry-fixtures",
+    "bin/base-themes.mjs",
+    "workers/analytics-receiver.mjs",
+    "wrangler.analytics.jsonc",
+    "scripts/render-release-announcement.mjs",
+    "scripts/render-launch-actions.mjs",
+    "scripts/registry-plan.mjs",
+    "scripts/verify-launch-readiness.mjs",
+    "scripts/render-launch-status.mjs",
+    "scripts/verify-telemetry-report.mjs",
+    "scripts/verify-telemetry-fixtures.mjs",
+    "examples/dashboard/README.md",
+    "examples/dashboard/index.html",
+    "examples/dashboard/package.json",
+    "examples/dashboard/package-lock.json",
+    "examples/dashboard/src",
+    "examples/dashboard/tsconfig.app.json",
+    "examples/dashboard/tsconfig.json",
+    "examples/dashboard/tsconfig.node.json",
+    "examples/dashboard/vite.config.ts",
+    "examples/theme-customization/README.md",
+    "examples/theme-customization/index.html",
+    "examples/theme-customization/package.json",
+    "examples/theme-customization/package-lock.json",
+    "examples/theme-customization/src",
+    "examples/theme-customization/tsconfig.app.json",
+    "examples/theme-customization/tsconfig.json",
+    "examples/theme-customization/tsconfig.node.json",
+    "examples/theme-customization/vite.config.ts",
+    "examples/registry-copy/README.md",
+    "examples/registry-copy/plan-copy.mjs",
+    "examples/next/README.md",
+    "examples/next/app",
+    "examples/next/next-env.d.ts",
+    "examples/next/next.config.ts",
+    "examples/next/package.json",
+    "examples/next/package-lock.json",
+    "examples/next/tsconfig.json",
+    "examples/vite/README.md",
+    "examples/vite/index.html",
+    "examples/vite/package.json",
+    "examples/vite/package-lock.json",
+    "examples/vite/src",
+    "examples/vite/tsconfig.app.json",
+    "examples/vite/tsconfig.json",
+    "examples/vite/tsconfig.node.json",
+    "examples/vite/vite.config.ts"
   ],
   "exports": {
     ".": {
@@ -32,47 +126,96 @@
     },
     "./styles.css": "./dist/base-themes.css",
     "./registry.json": "./registry/registry.json",
+    "./shadcn-registry.json": "./registry/shadcn-registry.json",
+    "./registry/items/*.json": "./registry/items/*.json",
+    "./block-meta.json": "./src/docs/blockMeta.json",
+    "./component-meta.json": "./src/docs/componentMeta.json",
+    "./static-page-meta.json": "./src/docs/staticPageMeta.json",
+    "./theme-meta.json": "./src/docs/themeMeta.json",
+    "./token-contract.json": "./src/styles/tokenContract.json",
+    "./llms-full.txt": "./llms-full.txt",
+    "./llms.txt": "./llms.txt",
     "./skill": "./skills/base-themes/SKILL.md"
   },
+  "bin": {
+    "base-themes": "./bin/base-themes.mjs"
+  },
   "types": "./dist/types/lib.d.ts",
   "module": "./dist/base-themes.js",
   "scripts": {
     "dev": "vite",
     "build": "npm run build:docs && npm run build:types && npm run build:lib",
-    "build:docs": "tsc -b && vite build",
+    "build:docs": "tsc -b && vite build && node scripts/generate-seo.mjs",
     "build:types": "tsc -p tsconfig.lib.json",
     "build:lib": "vite build --config vite.lib.config.ts",
+    "bundle:report": "node scripts/report-bundle-size.mjs",
     "lint": "eslint .",
+    "test": "vitest run",
+    "registry:generate": "node scripts/generate-standard-registry.mjs",
     "registry:check": "node scripts/validate-registry.mjs",
+    "tokens:check": "node scripts/verify-token-contract.mjs",
+    "seo:check": "node scripts/verify-seo-coverage.mjs",
+    "telemetry:collect": "node scripts/collect-telemetry.mjs",
+    "telemetry:check": "node scripts/verify-telemetry-report.mjs",
+    "telemetry:fixtures": "node scripts/verify-telemetry-fixtures.mjs",
+    "launch:check": "node scripts/verify-launch-readiness.mjs",
+    "launch:status": "node scripts/render-launch-status.mjs",
+    "launch:actions": "node scripts/render-launch-actions.mjs",
+    "launch:campaign": "node scripts/render-launch-actions.mjs --live --write",
+    "release:announce": "node scripts/render-release-announcement.mjs",
+    "analytics:check": "node scripts/verify-analytics-receiver.mjs",
+    "community:check": "node scripts/verify-community-workflow.mjs",
+    "community:issues": "node scripts/render-contributor-issues.mjs",
     "previews:generate": "node scripts/generate-theme-previews.mjs",
+    "previews:check": "node scripts/verify-theme-previews.mjs",
     "themes:e2e": "node scripts/verify-themes-e2e.mjs",
-    "prepack": "npm run registry:check && npm run lint && npm run build",
-    "preview": "vite preview"
+    "package:smoke": "node scripts/verify-package-smoke.mjs",
+    "example:next:build": "npm --prefix examples/next ci && npm --prefix examples/next run build",
+    "example:vite:build": "npm --prefix examples/vite ci && npm --prefix examples/vite run build",
+    "example:dashboard:build": "npm --prefix examples/dashboard ci && npm --prefix examples/dashboard run build",
+    "example:theme-customization:build": "npm --prefix examples/theme-customization ci && npm --prefix examples/theme-customization run build",
+    "example:registry-copy": "node examples/registry-copy/plan-copy.mjs",
+    "prepack": "npm run registry:check && npm run tokens:check && npm run lint && npm run test && npm run build && npm run seo:check && npm run telemetry:fixtures && npm run launch:check && npm run bundle:report && npm run package:smoke",
+    "preview": "npm run build:docs && wrangler dev",
+    "deploy": "npm run build:docs && wrangler deploy"
   },
   "peerDependencies": {
     "@base-ui/react": "^1.5.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
   },
   "dependencies": {
     "clsx": "^2.1.1",
     "lucide-react": "^1.16.0"
   },
   "devDependencies": {
+    "@base-ui/react": "^1.5.0",
+    "@cloudflare/vite-plugin": "^1.39.0",
     "@eslint/js": "^10.0.1",
+    "@gsap/react": "^2.1.2",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/jest-axe": "^3.5.9",
     "@types/node": "^24.12.3",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
+    "@types/react": "^18.3.27",
+    "@types/react-dom": "^18.3.7",
     "@vitejs/plugin-react": "^6.0.1",
-    "@base-ui/react": "^1.5.0",
     "eslint": "^10.3.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.2",
     "globals": "^17.6.0",
+    "gsap": "^3.15.0",
+    "jest-axe": "^10.0.0",
+    "jsdom": "^29.1.1",
+    "pixelmatch": "^7.2.0",
+    "pngjs": "^7.0.0",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
     "typescript": "~6.0.2",
     "typescript-eslint": "^8.59.2",
     "vite": "^8.0.12",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6"
+    "vitest": "^4.1.7",
+    "wrangler": "^4.95.0"
   }
 }

package/registry/items/accordion.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "accordion",
+  "type": "registry:ui",
+  "title": "Accordion",
+  "description": "Stacked disclosure panels for related sections of content.",
+  "dependencies": [
+    "@base-ui/react",
+    "clsx",
+    "lucide-react"
+  ],
+  "files": [
+    {
+      "path": "src/components/ui/Accordion.tsx",
+      "type": "registry:ui",
+      "target": "@/components/ui/Accordion.tsx"
+    },
+    {
+      "path": "src/components/ui/Accordion.css",
+      "type": "registry:file",
+      "target": "@/components/ui/Accordion.css"
+    }
+  ],
+  "categories": [
+    "base-ui",
+    "component",
+    "disclosure"
+  ],
+  "meta": {
+    "baseThemes": {
+      "source": "package-and-source-copy",
+      "docsRoute": "/components/accordion",
+      "supportsStyles": [
+        "bento",
+        "shadcn",
+        "neo-brutalism",
+        "minimal",
+        "enterprise",
+        "linear",
+        "glass",
+        "terminal",
+        "material",
+        "fluent",
+        "retro",
+        "cyberpunk",
+        "editorial",
+        "calm",
+        "data-dense",
+        "playful",
+        "luxury",
+        "soft-ui",
+        "bauhaus",
+        "mono"
+      ],
+      "styleContract": [
+        "data-style",
+        "data-theme",
+        "src/index.css",
+        "src/styles/tokens.css",
+        "src/styles/themes.css",
+        "src/styles/shadcn.css",
+        "src/styles/neo-brutalism.css",
+        "src/styles/cyberpunk.css",
+        "src/styles/terminal.css",
+        "src/styles/material.css",
+        "src/styles/glass.css"
+      ]
+    },
+    "agent": {
+      "summary": "Use Accordion when a React UI needs stacked disclosure panels for related sections of content.",
+      "whenToUse": [
+        "Disclosure",
+        "Base UI wrapper",
+        "CSS token theme support"
+      ],
+      "packageInstall": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { Accordion } from 'base-themes'"
+      ],
+      "sourceCopy": [
+        "fetch /registry/items/accordion.json",
+        "copy every files[].path to files[].target",
+        "copy every registry.style.files entry once",
+        "install dependencies from dependencies[]"
+      ],
+      "installPlan": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { Accordion } from 'base-themes'",
+        "or fetch /registry/items/accordion.json for source-copy"
+      ],
+      "verify": [
+        "npm run registry:check",
+        "npm run tokens:check",
+        "npm run lint",
+        "npm run build"
+      ]
+    }
+  }
+}

package/registry/items/alert-dialog.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "alert-dialog",
+  "type": "registry:ui",
+  "title": "Alert Dialog",
+  "description": "A confirmation modal for actions that need explicit acknowledgement.",
+  "dependencies": [
+    "@base-ui/react",
+    "clsx",
+    "lucide-react"
+  ],
+  "files": [
+    {
+      "path": "src/components/ui/AlertDialog.tsx",
+      "type": "registry:ui",
+      "target": "@/components/ui/AlertDialog.tsx"
+    },
+    {
+      "path": "src/components/ui/AlertDialog.css",
+      "type": "registry:file",
+      "target": "@/components/ui/AlertDialog.css"
+    },
+    {
+      "path": "src/components/ui/Button.css",
+      "type": "registry:file",
+      "target": "@/components/ui/Button.css"
+    }
+  ],
+  "categories": [
+    "base-ui",
+    "component",
+    "disclosure",
+    "overlay"
+  ],
+  "meta": {
+    "baseThemes": {
+      "source": "package-and-source-copy",
+      "docsRoute": "/components/alertdialog",
+      "supportsStyles": [
+        "bento",
+        "shadcn",
+        "neo-brutalism",
+        "minimal",
+        "enterprise",
+        "linear",
+        "glass",
+        "terminal",
+        "material",
+        "fluent",
+        "retro",
+        "cyberpunk",
+        "editorial",
+        "calm",
+        "data-dense",
+        "playful",
+        "luxury",
+        "soft-ui",
+        "bauhaus",
+        "mono"
+      ],
+      "styleContract": [
+        "data-style",
+        "data-theme",
+        "src/index.css",
+        "src/styles/tokens.css",
+        "src/styles/themes.css",
+        "src/styles/shadcn.css",
+        "src/styles/neo-brutalism.css",
+        "src/styles/cyberpunk.css",
+        "src/styles/terminal.css",
+        "src/styles/material.css",
+        "src/styles/glass.css"
+      ]
+    },
+    "agent": {
+      "summary": "Use Alert Dialog when a React UI needs a confirmation modal for actions that need explicit acknowledgement.",
+      "whenToUse": [
+        "Disclosure",
+        "Base UI wrapper",
+        "CSS token theme support"
+      ],
+      "packageInstall": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { AlertDialog } from 'base-themes'"
+      ],
+      "sourceCopy": [
+        "fetch /registry/items/alert-dialog.json",
+        "copy every files[].path to files[].target",
+        "copy every registry.style.files entry once",
+        "install dependencies from dependencies[]"
+      ],
+      "installPlan": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { AlertDialog } from 'base-themes'",
+        "or fetch /registry/items/alert-dialog.json for source-copy"
+      ],
+      "verify": [
+        "npm run registry:check",
+        "npm run tokens:check",
+        "npm run lint",
+        "npm run build"
+      ]
+    }
+  }
+}

package/registry/items/autocomplete.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "autocomplete",
+  "type": "registry:ui",
+  "title": "Autocomplete",
+  "description": "A text input with filtered suggestions and inline selection behavior.",
+  "dependencies": [
+    "@base-ui/react",
+    "clsx",
+    "lucide-react"
+  ],
+  "files": [
+    {
+      "path": "src/components/ui/Autocomplete.tsx",
+      "type": "registry:ui",
+      "target": "@/components/ui/Autocomplete.tsx"
+    },
+    {
+      "path": "src/components/ui/Autocomplete.css",
+      "type": "registry:file",
+      "target": "@/components/ui/Autocomplete.css"
+    },
+    {
+      "path": "src/components/ui/Combobox.css",
+      "type": "registry:file",
+      "target": "@/components/ui/Combobox.css"
+    }
+  ],
+  "categories": [
+    "base-ui",
+    "component",
+    "inputs"
+  ],
+  "meta": {
+    "baseThemes": {
+      "source": "package-and-source-copy",
+      "docsRoute": "/components/autocomplete",
+      "supportsStyles": [
+        "bento",
+        "shadcn",
+        "neo-brutalism",
+        "minimal",
+        "enterprise",
+        "linear",
+        "glass",
+        "terminal",
+        "material",
+        "fluent",
+        "retro",
+        "cyberpunk",
+        "editorial",
+        "calm",
+        "data-dense",
+        "playful",
+        "luxury",
+        "soft-ui",
+        "bauhaus",
+        "mono"
+      ],
+      "styleContract": [
+        "data-style",
+        "data-theme",
+        "src/index.css",
+        "src/styles/tokens.css",
+        "src/styles/themes.css",
+        "src/styles/shadcn.css",
+        "src/styles/neo-brutalism.css",
+        "src/styles/cyberpunk.css",
+        "src/styles/terminal.css",
+        "src/styles/material.css",
+        "src/styles/glass.css"
+      ]
+    },
+    "agent": {
+      "summary": "Use Autocomplete when a React UI needs a text input with filtered suggestions and inline selection behavior.",
+      "whenToUse": [
+        "Inputs",
+        "Base UI wrapper",
+        "CSS token theme support"
+      ],
+      "packageInstall": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { Autocomplete } from 'base-themes'"
+      ],
+      "sourceCopy": [
+        "fetch /registry/items/autocomplete.json",
+        "copy every files[].path to files[].target",
+        "copy every registry.style.files entry once",
+        "install dependencies from dependencies[]"
+      ],
+      "installPlan": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { Autocomplete } from 'base-themes'",
+        "or fetch /registry/items/autocomplete.json for source-copy"
+      ],
+      "verify": [
+        "npm run registry:check",
+        "npm run tokens:check",
+        "npm run lint",
+        "npm run build"
+      ]
+    }
+  }
+}

package/registry/items/avatar.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "avatar",
+  "type": "registry:ui",
+  "title": "Avatar",
+  "description": "A compact identity primitive with fallback initials and grouped presentation.",
+  "dependencies": [
+    "@base-ui/react",
+    "clsx",
+    "lucide-react"
+  ],
+  "files": [
+    {
+      "path": "src/components/ui/Avatar.tsx",
+      "type": "registry:ui",
+      "target": "@/components/ui/Avatar.tsx"
+    },
+    {
+      "path": "src/components/ui/Avatar.css",
+      "type": "registry:file",
+      "target": "@/components/ui/Avatar.css"
+    }
+  ],
+  "categories": [
+    "base-ui",
+    "component",
+    "feedback"
+  ],
+  "meta": {
+    "baseThemes": {
+      "source": "package-and-source-copy",
+      "docsRoute": "/components/avatar",
+      "supportsStyles": [
+        "bento",
+        "shadcn",
+        "neo-brutalism",
+        "minimal",
+        "enterprise",
+        "linear",
+        "glass",
+        "terminal",
+        "material",
+        "fluent",
+        "retro",
+        "cyberpunk",
+        "editorial",
+        "calm",
+        "data-dense",
+        "playful",
+        "luxury",
+        "soft-ui",
+        "bauhaus",
+        "mono"
+      ],
+      "styleContract": [
+        "data-style",
+        "data-theme",
+        "src/index.css",
+        "src/styles/tokens.css",
+        "src/styles/themes.css",
+        "src/styles/shadcn.css",
+        "src/styles/neo-brutalism.css",
+        "src/styles/cyberpunk.css",
+        "src/styles/terminal.css",
+        "src/styles/material.css",
+        "src/styles/glass.css"
+      ]
+    },
+    "agent": {
+      "summary": "Use Avatar when a React UI needs a compact identity primitive with fallback initials and grouped presentation.",
+      "whenToUse": [
+        "Feedback",
+        "Base UI wrapper",
+        "CSS token theme support"
+      ],
+      "packageInstall": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { Avatar } from 'base-themes'"
+      ],
+      "sourceCopy": [
+        "fetch /registry/items/avatar.json",
+        "copy every files[].path to files[].target",
+        "copy every registry.style.files entry once",
+        "install dependencies from dependencies[]"
+      ],
+      "installPlan": [
+        "npm install base-themes @base-ui/react react react-dom",
+        "import base-themes/styles.css once",
+        "import { Avatar } from 'base-themes'",
+        "or fetch /registry/items/avatar.json for source-copy"
+      ],
+      "verify": [
+        "npm run registry:check",
+        "npm run tokens:check",
+        "npm run lint",
+        "npm run build"
+      ]
+    }
+  }
+}