sparkdesign 0.4.6 → 0.4.7

package/dist/tokens/scale/presets/dense.css

@@ -49,14 +49,25 @@
   /* ChatInput 特殊配置 */
   --chat-status-overlap: 4px;
 
-  /* Font Size (更小) */
-  --font-size-base: 12px;
+  /* Font Size (信息密集：主力 text-sm 也压缩) */
+  --font-size-xs: 11px;
+  --font-size-xs--line-height: 14px;
+  --font-size-sm: 12px;
+  --font-size-sm--line-height: 16px;
+  --font-size-base: 13px;
+  --font-size-base--line-height: 18px;
   --font-size-lg: 14px;
+  --font-size-lg--line-height: 20px;
   --font-size-xl: 14px;
+  --font-size-xl--line-height: 20px;
   --font-size-2xl: 16px;
+  --font-size-2xl--line-height: 22px;
   --font-size-3xl: 18px;
+  --font-size-3xl--line-height: 24px;
   --font-size-4xl: 22px;
+  --font-size-4xl--line-height: 28px;
   --font-size-5xl: 28px;
+  --font-size-5xl--line-height: 32px;
   --font-size-6xl: 36px;
   --font-size-7xl: 44px;
   --font-size-8xl: 56px;

package/dist/tokens/scale/presets/sharp.css

@@ -1,12 +1,14 @@
 /* ============================================
  * Preset: Sharp - 锐利风格
- * 几何精度，无圆角 + 等宽字体
+ * 几何精度，无圆角 + 等宽字体 + 硬朗节奏
  * ============================================ */
 
 [data-style="sharp"] {
-  /* Spacing (与 compact 相同) */
+  /* Spacing (方正、克制，少量压缩) */
   --spacing-3: 10px;
   --spacing-4: 14px;
+  --spacing-5: 18px;
+  --spacing-6: 22px;
   --spacing-9: 32px;
   --spacing-11: 40px;
 
@@ -25,13 +27,23 @@
   --font-sans: var(--config-font-mono);
   font-family: var(--font-sans);
 
-  /* Font Size (与 compact 相同) */
-  --font-size-sm: 12px;
-  --font-size-lg: 14px;
-  --font-size-xl: 16px;
+  /* Font Size (工程感：略紧、等宽、层级清楚) */
+  --font-size-xs: 12px;
+  --font-size-xs--line-height: 16px;
+  --font-size-sm: 13px;
+  --font-size-sm--line-height: 18px;
+  --font-size-base: 14px;
+  --font-size-base--line-height: 20px;
+  --font-size-lg: 15px;
+  --font-size-lg--line-height: 22px;
+  --font-size-xl: 17px;
+  --font-size-xl--line-height: 24px;
   --font-size-2xl: 18px;
+  --font-size-2xl--line-height: 24px;
   --font-size-3xl: 22px;
+  --font-size-3xl--line-height: 28px;
   --font-size-4xl: 28px;
+  --font-size-4xl--line-height: 32px;
   --font-size-5xl: 34px;
   --font-size-6xl: 44px;
   --font-size-7xl: 56px;

package/dist/tokens/scale/presets/soft.css

@@ -4,7 +4,17 @@
  * ============================================ */
 
 [data-style="soft"] {
-  /* 只覆盖 Radius (大圆角) */
+  /* Spacing (舒展留白) */
+  --spacing-3: 14px;
+  --spacing-4: 18px;
+  --spacing-5: 24px;
+  --spacing-6: 28px;
+  --spacing-8: 36px;
+  --spacing-9: 40px;
+  --spacing-11: 48px;
+  --spacing-12: 56px;
+
+  /* Radius (大圆角) */
   --radius-sm: 8px;
   --radius-DEFAULT: 12px;
   --radius-md: 12px;
@@ -13,4 +23,16 @@
   --radius-2xl: 24px;
   --radius-3xl: 28px;
   --radius: var(--radius-DEFAULT);
+
+  /* Font Size (阅读舒适，行高更松) */
+  --font-size-sm: 14px;
+  --font-size-sm--line-height: 22px;
+  --font-size-base: 15px;
+  --font-size-base--line-height: 24px;
+  --font-size-lg: 17px;
+  --font-size-lg--line-height: 26px;
+  --font-size-xl: 20px;
+  --font-size-xl--line-height: 28px;
+  --font-size-2xl: 22px;
+  --font-size-2xl--line-height: 30px;
 }

package/docs/agent/component-selection.md

@@ -0,0 +1,60 @@
+# Agent Component Selection
+
+This guide is the human-readable companion to `registry/agent-manifest.json`.
+Agents should read the manifest first, then source files only when implementation
+details are needed.
+
+## Entry Points
+
+- `sparkdesign/agent-manifest.json` — package export for agent-facing component semantics.
+- `registry/agent-manifest.json` — source of truth in this repository.
+- `npm run check:agent-manifest` — validates required semantic fields and recipe references.
+
+## Decision Order
+
+1. Choose by `intent`, not by component name similarity.
+2. Check `antiPatterns` before composing a component into a generated screen.
+3. Prefer `recipes` for common agent workflows before inventing a new layout.
+4. Use `cliAdd` when the target app should own copied component source.
+5. Use `packageImport` only when the app already consumes `sparkdesign` as a package.
+
+## Current High-Confidence Coverage
+
+The first manifest version covers the components most likely to be selected by
+design/coding agents:
+
+- `button`
+- `alert`
+- `card`
+- `dialog`
+- `drawer`
+- `file-review-part`
+- `chat-input`
+- `response`
+- `markdown`
+- `permission-card`
+- `tool-invocation-card`
+
+## Recipe Usage
+
+Recipes are intended to prevent agents from flattening rich AI interfaces into
+generic cards and Markdown.
+
+- `assistant-composer` — prompt entry, attachments, send, and permissions.
+- `assistant-response-stream` — generated answer, tools, Markdown, and errors.
+- `focused-task-modal` — compact blocking task or confirmation flow.
+- `settings-drawer` — contextual settings/details while preserving page context.
+- `tool-approval-flow` — explicit approval before risky agent tool actions.
+- `file-review-flow` — agent file changes, review decisions, and approval.
+- `empty-state-with-prompts` — empty states that guide users into AI workflows.
+
+## Maintenance Rule
+
+When adding a component to the manifest:
+
+1. Confirm the component exists in `registry/meta.json`.
+2. Fill `intent`, `slots`, `states`, `a11y`, `composition`, `antiPatterns`, and `agentHints`.
+3. Ensure `packageImport` uses names exported by `src/components/index.ts`.
+4. Ensure `cliAdd` installs the same component id as the manifest key.
+5. Add or update recipes if the component changes how agents should compose screens.
+6. Run `npm run check:agent-manifest`.

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.6",
+  "version": "0.4.7",
   "type": "module",
   "description": "Modern React Design System with dual-dimension theme system",
   "keywords": [
@@ -30,14 +30,20 @@
     "./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",
@@ -49,9 +55,12 @@
     "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",
+    "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/sparkdesign.css --minify",
@@ -70,7 +79,7 @@
     "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 build && node scripts/sync-registry-to-cli.mjs && npm run check:registry-meta"
+    "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",
@@ -82,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",
@@ -98,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",
@@ -128,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",