sparkdesign 0.4.6 → 0.4.8

package/AI_README.md

@@ -0,0 +1,60 @@
+# Spark Design AI Entrypoint
+
+This file is the shortest path for design and coding agents that need to use
+Spark Design correctly.
+
+## Read Order
+
+1. `registry/agent-manifest.json` — choose components by intent, slots, states, accessibility, composition, and anti-patterns.
+2. `registry/tokens/ontology.json` — choose token families by semantic purpose before writing styles.
+3. `docs/guides/agent-usage.md` — consumption rules for CLI copy vs package import.
+4. Component source only after the manifest tells you which component to use.
+
+For npm package consumers:
+
+```ts
+import manifest from 'sparkdesign/agent-manifest.json'
+import ontology from 'sparkdesign/token-ontology.json'
+```
+
+## Default Decisions
+
+- Prefer `npx sparkdesign@latest add <component>` when building a business app that should own component source.
+- Prefer `import { Component } from 'sparkdesign'` only for prototypes, showcase usage, or projects already using the package runtime.
+- Use `basic/*` for product primitives and `chat/*` for assistant, tool, file, reasoning, and response flows.
+- Use `data-theme` for color and `data-style` for density, radius, and rhythm.
+
+## Hard Rules
+
+- Do not invent duplicate components when a Spark component already matches the intent.
+- Do not hard-code hex colors, raw rgb/rgba overlays, arbitrary radii, or one-off px spacing in published UI source.
+- Do not flatten structured AI output into plain Markdown when `Response`, `ToolInvocationCard`, `PermissionCard`, or related chat components apply.
+- Do not use accent colors to communicate status without text or icon labels.
+- Do not bypass portal theme inheritance for Dialog, Drawer, Tooltip, DropdownMenu, Toast, or other floating layers.
+
+## Verification Commands
+
+Run these before handing work back:
+
+```bash
+npm run check:agent-manifest
+npm run check:token-ontology
+npm run check:token-antipatterns
+npm run lint
+npm run test:run
+```
+
+For publishing or registry-affecting changes, also run:
+
+```bash
+npm run check:registry-meta
+npm run check:registry
+npm run build
+npm run size
+```
+
+## When Unsure
+
+If the manifest and ontology do not describe the pattern you need, update them
+before relying on source-code intuition. The semantic map must stay aligned with
+the implementation terrain.

package/README.md

@@ -2,7 +2,7 @@
 
 现代化 React 设计系统，支持双维度主题（颜色 theme + 布局 scale），5 种内置布局风格，提供 Basic 基础组件与 Chat 对话流组件，可扩展颜色主题。
 
-**当前版本**：`0.4.5`（[CLI 快速上手](docs/getting-started-cli.md) / [NPM 快速上手](docs/getting-started.md)）
+**当前版本**：`0.4.6`（[CLI 快速上手](docs/getting-started-cli.md) / [NPM 快速上手](docs/getting-started.md)）
 
 > 🌟 **纯新手？** 查看 [CLI 快速上手指南](docs/getting-started-cli.md)，一步步带你跑起来！
 

package/cli/dist/commands/add.js

@@ -21,7 +21,7 @@ import { ensureTsAlias } from '../utils/tsconfig.js';
 export async function add(components, options = {}) {
     const cwd = process.cwd();
     const registryRoot = getRegistryRoot();
-    let config = await readConfig(cwd);
+    const config = await readConfig(cwd);
     const hasConfig = await fs.pathExists(path.join(cwd, 'components.json'));
     if (!hasConfig) {
         await writeConfig(config, cwd);

package/cli/dist/commands/init.js

@@ -167,5 +167,5 @@ export async function init() {
     }
     await fs.ensureDir(path.join(cwd, componentsDir));
     console.log(chalk.green('✓'), 'Default theme preset:', chalk.cyan(`appearance=${appearance}`), chalk.cyan(`theme=${theme}`), chalk.gray(`(data-theme="${getDataThemeLabel(appearance, theme)}", data-style="${style}")`));
-    console.log(chalk.green('✓'), 'Spark Design initialized. Run'), chalk.cyan('npx sparkdesign add button'), chalk.green('to add components.');
+    console.log(chalk.green('✓'), 'Spark Design initialized. Run', chalk.cyan('npx sparkdesign add button'), chalk.green('to add components.'));
 }

package/cli/registry/AGENTS.md

@@ -4,14 +4,21 @@
 
 ## Member list
 
-> Complete this section with **one line per file** (and major folders): `basic/`, `chat/`, `lib/`, `tokens/`, `meta.json`, `__tests__/`, etc. The filesystem is the source of truth.
+- `basic/` — alert, alert-dialog, aspect-ratio, avatar, breadcrumb, button, button-group, calendar, card, carousel, chart, checkbox, collapse, collapsible, collapsible-card, combobox, command, context-menu, data-table, date-picker, dialog, direction, drawer, dropdown-menu, empty, field, hover-card, icon-button, input, input-group, input-otp, item, kbd, label, menubar, native-select, navigation-menu, option-list, pagination, popover, progress, radio-group, resizable, scroll-area, scrollbar, select, separator, sheet, shimmering-text, sidebar-menu, skeleton, slider, sonner, spinner, switch, table, tabs, tag, textarea, toggle, tooltip, typography.
+- `chat/` — ask-user-part, browser-action-part, chat-input, code-block-part, conversation-anchor-nav, file-attachment, file-card, file-review-part, folder-button, generated-images-grid, generation-status-bar, hint-banner, image-attachment, image-generating, markdown, mermaid-part, permission-card, plan-part, queue-indicator, reasoning-step, related-prompts, response, send-button, streaming-markdown-block, task-part, terminal-code-block-part, thinking-indicator, tool-invocation-card, user-message, user-question, user-question-answer.
+- `lib/` — file-icon-maps, use-mermaid-render, utils; helper modules copied with registry components when needed.
+- `tokens/` — index.css, theme.css, theme-base.css, scale.css, ontology.json, scrollbar utility, theme presets, and scale token packs.
+- `meta.json` — generated component dependency/file manifest; validate with `npm run check:registry-meta`.
+- `agent-manifest.json` — hand-authored component intent, constraints, and recipes for design/coding agents; validate with `npm run check:agent-manifest`.
+- `__tests__/` — registry-level component tests for basic and chat components.
 
 ## Submodules
 
 - `basic/`, `chat/` — component source files consumed by the library and CLI
 - `lib/` — shared helpers bundled with registry copies
-- `tokens/` — CSS token packs synced to `cli/registry`
+- `tokens/` — CSS token packs and token ontology synced to `cli/registry`
 - `__tests__/` — component tests
+- `agent-manifest.json` — machine-readable AI consumption protocol
 
 ---