sparkdesign 0.4.5 → 0.4.7

package/docs/agent/token-ontology.md

@@ -0,0 +1,37 @@
+# Agent Token Ontology
+
+`registry/tokens/ontology.json` is the machine-readable companion to Spark
+Design token CSS. It explains what token families mean, where agents should use
+them, and which patterns are forbidden.
+
+## Package Entry
+
+```ts
+import ontology from 'sparkdesign/token-ontology.json'
+```
+
+Use this before inventing custom colors, spacing, radii, or motion values.
+
+## Selection Order
+
+1. Pick the correct axis: `data-theme` for color, `data-style` for layout rhythm.
+2. Pick a token family by intent, not by visual resemblance.
+3. Check `avoidFor` and `agentRules` before using a family.
+4. Use existing semantic utilities or `var(--token-name)` bindings.
+5. Do not hard-code hex, raw rgba overlays, arbitrary radii, or one-off spacing.
+
+## Agent Defaults
+
+- Use `data-theme="light"` and `data-style="neutral"` when no preference is known.
+- Use `compact` or `dense` only for data-heavy surfaces.
+- Use `soft` for airy onboarding or approachable product surfaces.
+- Use `sharp` only when square geometry is an explicit visual direction.
+- Use semantic color families for status; do not repurpose accent colors for errors or warnings.
+
+## Maintenance
+
+When token CSS changes the public semantic surface:
+
+1. Update `registry/tokens/ontology.json`.
+2. Run `npm run check:token-ontology`.
+3. Update this document if the agent decision model changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sparkdesign",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "type": "module",
   "description": "Modern React Design System with dual-dimension theme system",
   "keywords": [
@@ -21,23 +21,29 @@
   },
   "exports": {
     ".": {
-      "types": "./dist/components/index.d.ts",
+      "types": "./dist/src/components/index.d.ts",
       "import": "./dist/spark-design.es.js",
       "require": "./dist/spark-design.cjs.js"
     },
-    "./style": "./dist/qoder-design.css",
+    "./style": "./dist/sparkdesign.css",
     "./theme.css": "./dist/theme.css",
     "./scale.css": "./dist/scale.css",
     "./katex.css": "./dist/katex.css",
     "./theme-base.css": "./dist/theme-base.css",
+    "./agent-manifest.json": "./registry/agent-manifest.json",
+    "./token-ontology.json": "./registry/tokens/ontology.json",
     "./tokens/*": "./dist/tokens/*",
     "./themes/*": "./dist/themes/*",
     "./scale/*": "./dist/scale/*"
   },
   "files": [
+    "AI_README.md",
     "dist",
     "cli/dist",
-    "cli/registry"
+    "cli/registry",
+    "docs/agent",
+    "registry/agent-manifest.json",
+    "registry/tokens/ontology.json"
   ],
   "sideEffects": [
     "*.css",
@@ -45,14 +51,19 @@
   ],
   "scripts": {
     "dev": "vite",
+    "codemod:p3-headers": "node scripts/codemod-p3-dip-headers.mjs",
+    "i18n:p3-en": "node scripts/translate-p3-headers-en.mjs",
     "gen:registry-meta": "node scripts/generate-registry-meta.mjs",
     "check:registry-meta": "node scripts/generate-registry-meta.mjs --check && node scripts/validate-registry-meta.mjs registry && node scripts/validate-registry-meta.mjs cli",
+    "check:agent-manifest": "node scripts/validate-agent-manifest.mjs",
+    "check:token-ontology": "node scripts/validate-token-ontology.mjs",
+    "check:token-antipatterns": "node scripts/check-token-antipatterns.mjs",
     "check:registry": "node scripts/check-registry-sync.mjs",
-        "check:showcase": "node scripts/check-showcase-sync.mjs",
-            "gen:demo": "node scripts/gen-demo.mjs",
-    "build": "vite build && npx @tailwindcss/cli -i src/lib.css -o dist/qoder-design.css --minify && tsc -p tsconfig.lib.json && npm run build:cli",
+    "check:showcase": "node scripts/check-showcase-sync.mjs",
+    "gen:demo": "node scripts/gen-demo.mjs",
+    "build": "vite build && npx @tailwindcss/cli -i src/lib.css -o dist/sparkdesign.css --minify && tsc -p tsconfig.lib.json && npm run build:cli",
     "build:cli": "cd cli && npm run build",
-    "build:css": "npx @tailwindcss/cli -i src/lib.css -o dist/qoder-design.css --minify",
+    "build:css": "npx @tailwindcss/cli -i src/lib.css -o dist/sparkdesign.css --minify",
     "build:watch": "vite build --watch",
     "preview": "vite preview",
     "lint": "eslint .",
@@ -64,7 +75,11 @@
     "test:e2e:ui": "playwright test --ui",
     "size": "size-limit",
     "size:why": "size-limit --why",
-    "prepublishOnly": "node scripts/generate-registry-meta.mjs && npm run build && node scripts/sync-registry-to-cli.mjs && npm run check:registry-meta"
+    "test:smoke": "node scripts/smoke-test-cli.mjs",
+    "test:smoke:vite": "node scripts/smoke-test-cli.mjs vite",
+    "test:smoke:next": "node scripts/smoke-test-cli.mjs nextjs",
+    "test:smoke:add": "node scripts/smoke-test-cli.mjs pure-add",
+    "prepublishOnly": "node scripts/generate-registry-meta.mjs && npm run check:agent-manifest && npm run check:token-ontology && npm run check:token-antipatterns && npm run build && node scripts/sync-registry-to-cli.mjs && npm run check:registry-meta"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -76,12 +91,20 @@
   "dependencies": {
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",
+    "@radix-ui/react-aspect-ratio": "^1.1.8",
     "@radix-ui/react-avatar": "^1.1.11",
+    "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-context-menu": "^2.2.16",
+    "@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-radio-group": "^1.3.8",
     "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-separator": "^1.1.8",
     "@radix-ui/react-slider": "^1.3.6",
     "@radix-ui/react-switch": "^1.2.6",
     "@radix-ui/react-tabs": "^1.1.2",
@@ -92,20 +115,27 @@
     "chalk": "^5.3.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
     "commander": "^12.1.0",
     "diff": "^7.0.0",
+    "embla-carousel-react": "^8.6.0",
     "execa": "^9.5.2",
     "framer-motion": "^12.34.0",
     "fs-extra": "^11.2.0",
     "i18next": "^25.8.7",
+    "input-otp": "^1.4.2",
     "katex": "^0.16.28",
     "lottie-react": "^2.4.1",
+    "lucide-react": "^1.8.0",
     "ora": "^8.1.1",
     "prism-react-renderer": "^2.4.1",
     "prompts": "^2.4.2",
+    "radix-ui": "^1.4.3",
+    "react-day-picker": "^9.14.0",
     "react-i18next": "^16.5.4",
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^4.6.2",
+    "recharts": "^3.8.1",
     "rehype-katex": "^7.0.1",
     "remark-gfm": "^4.0.1",
     "remark-math": "^6.0.0",
@@ -122,6 +152,8 @@
     "@size-limit/file": "^12.0.0",
     "@tailwindcss/cli": "^4.1.18",
     "@tailwindcss/vite": "^4.1.18",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
     "@types/node": "^24.10.13",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",