agentcss 0.16.1 → 0.24.1

package/09-assets/echarts-adapter/demo.html

@@ -33,7 +33,7 @@ td.num { text-align: right; font-family: var(--mono); font-variant-numeric: tabu
             vertical-align:middle; margin-right:4px; }
 </style>
 </head>
-<body class="page page">
+<body class="page">
 <div class="wrap">
   <h1>图表规范</h1>
   <p class="lede">

package/09-assets/model-viewer/demo.html

@@ -28,7 +28,7 @@ td.num { text-align: right; font-family: var(--mono); font-variant-numeric: tabu
 .ok { color: var(--success); }
 </style>
 </head>
-<body class="page page">
+<body class="page">
 <main class="wrap">
 
   <h1>3D 模型查看器</h1>

package/09-assets/sparkline/demo.html

@@ -32,7 +32,7 @@
                     /* 🔴 但别小于 40 */
 </style>
 </head>
-<body class="page page">
+<body class="page">
 <main class="wrap">
   <h1>sparkline · 迷你趋势图</h1>
   <p class="lede">

package/AGENTS.md

@@ -0,0 +1,8 @@
+# agentcss — for coding agents
+
+- **Contract (machine-readable):** `ai/components.json` — 39 components with root class, slots, variants, states, ARIA and file paths. Query it; never guess class names.
+- **Known failure modes:** `ai/pitfalls.json`, or `npx agentcss ai pitfalls --json --component=<id>`.
+- **Query:** `npx agentcss ai components --json [--maturity=stable]` · `ai tokens --json [--set=dark]` · `ai tree --json`.
+- **Validate:** `npx agentcss ai validate <file> --schema=components --json`. Every subcommand accepts `--json`; failures print `{"ok":false,…}` and exit non-zero.
+- **Markup ground truth:** each component's `demo.html`. Restyle through tokens (CSS variables); never rewrite component selectors.
+- **Docs are Chinese:** `ai/START-HERE.md` (navigation). English entry points: `README.md`, `llms.txt`, `llms-full.txt`.

package/API.md

@@ -75,6 +75,8 @@ import { Accordion, Tabs, Select } from 'agentcss/esm';
 | `Pagination` | ✅ | create | `create` `update` `pagesOf` |
 | `Accordion` | ✅ | **construct** | 实例方法在原型上：`toggle` `set` `bind` `init` … |
 | `Tabs` | ✅ | **construct** | 实例方法在原型上：`select` `focusables` `enabled` `rove` `bind`（方向键游走已并入 roving 核） |
+| `Upload` | ✅ | **construct** | 实例方法在原型上：`add` `removeAt` `setProgress` `render` `destroy`（`new Upload(root, { maxSize, maxFiles })`；自动初始化时读 `data-max-size` / `data-max-files`）|
+| `ShellNav` | ✅ | **construct** | 实例方法在原型上：`open` `close` `destroy`（`new ShellNav(root, { label, place })`）。本层只做接线，抽屉的行为由 drawer.js 提供 |
 | `Tooltip` | ✅ | attach | `attach` |
 | `Popover` | ✅ | attach | `attach` `closeAll` `current` |
 | `Overlay` | ✅ | direct | `dialog` `toast` |
@@ -139,6 +141,8 @@ window.ScientificPlot.render(el, {
 | `FLIP` | 否 | 必须 `FLIP.flip(...)` |
 | `ModelViewer` | 是 | 扫 `[data-mv]`（模型加载后自动 `update()`） |
 | `ScientificPlot` | 否 | 必须 `ScientificPlot.render(el, opts)` |
+| `Upload` | 是 | 扫 `[data-upload]`，实例挂在 `el.uploadInstance`（幂等；缺 `.upload__input` 时 console.warn 后跳过该元素） |
+| `ShellNav` | 是 | 扫 `[data-shell-nav]`（值 = 抽屉标题），实例挂在 `el.shellNavInstance`。幂等；缺 `Drawer` 或缺 `.shell__side` 时 console.warn 后跳过 —— **不注入按钮**，不留一个点不动的按钮 |
 <!-- autoinit-table:end -->
 
 **为什么不做成"全都自动"**：需要 options 的组件（`Select.create(root, opts)`）