@morya-ui/setup 0.3.3 → 0.3.4

package/template/.cursor/rules/coding-style.mdc

@@ -1,41 +1,41 @@
----
-description: Vue 3 + TypeScript 业务代码风格（Morya UI 项目）
-globs: "**/*.{ts,vue}"
-alwaysApply: false
----
-
-# 编码风格
-
-## Vue
-
-- 使用 `<script setup lang="ts">`。
-- 组件名 PascalCase；模板中用 `M*` 前缀组件。
-- `v-model` 与组件库 emit 对齐（如 `v-model:page`）。
-- 页面级样式 `scoped`；仅使用 `--m-*` 与设计令牌。
-
-## TypeScript
-
-- Props/emit 显式类型；避免 `any`。
-- 异步提交：`loading` ref + `try/finally`。
-
-## 文件组织
-
-```text
-src/
-  views/          # 路由页面
-  components/     # 业务组件
-  composables/    # 复用逻辑
-  api/            # 请求层
-```
-
-## 命名
-
-- 页面：`UserListView.vue` / `UserFormView.vue`
-- 路由 path kebab-case：`/users/create`
-
-## 检查
-
-```bash
-pnpm check:colors   # 裸色值扫描
-pnpm typecheck
-```
+---
+description: Vue 3 + TypeScript 业务代码风格（Morya UI 项目）
+globs: "**/*.{ts,vue}"
+alwaysApply: false
+---
+
+# 编码风格
+
+## Vue
+
+- 使用 `<script setup lang="ts">`。
+- 组件名 PascalCase；模板中用 `M*` 前缀组件。
+- `v-model` 与组件库 emit 对齐（如 `v-model:page`）。
+- 页面级样式 `scoped`；仅使用 `--m-*` 与设计令牌。
+
+## TypeScript
+
+- Props/emit 显式类型；避免 `any`。
+- 异步提交：`loading` ref + `try/finally`。
+
+## 文件组织
+
+```text
+src/
+  views/          # 路由页面
+  components/     # 业务组件
+  composables/    # 复用逻辑
+  api/            # 请求层
+```
+
+## 命名
+
+- 页面：`UserListView.vue` / `UserFormView.vue`
+- 路由 path kebab-case：`/users/create`
+
+## 检查
+
+```bash
+pnpm check:colors   # 裸色值扫描
+pnpm typecheck
+```

package/template/.cursor/rules/component-usage.mdc

@@ -1,41 +1,41 @@
----
-description: Morya UI 组件用法与选型（Vue 业务代码）
-globs: src/**/*.vue
-alwaysApply: false
----
-
-# 组件用法
-
-## 引入
-
-```ts
-import { MButton, MInput } from 'morya-ui'
-// 按需：import MButton from 'morya-ui/button'
-//        import 'morya-ui/button/style'
-```
-
-## 必选模式
-
-- 表单：`MForm` + `MFormItem` + 字段组件；提交用 `@submit` + `type="submit"`。
-- 表格：`MTable` 的 `columns` + `rows` + `row-key`；单元格用 `#cell-{key}` 插槽。没有 `data` prop。
-- 浮层：详情/编辑 `MDialog`；侧栏 `MDrawer`；删除确认 `MConfirmDialog`。
-- 反馈（**默认 Message**）：
-  - 单行操作结果 → `message.success/info/warn/error('…')`
-  - 有标题 + 详情 / 异步通知 → `toast.*({ summary, detail })`
-  - 表单区常驻错误 → 字段 `errorMessage`，或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主，不是内嵌 Alert）
-  - 详见 skill `references/feedback.md`
-
-## Props 约定
-
-- 尺寸：`size="small" | "large"`（默认 medium）。
-- 危险：`severity="danger"` 或 `invalid` + `errorMessage`。
-- 清除：优先 `clearable`（Select 亦支持 `showClear` 别名）。
-- 宽度：表单字段 `fluid`；页面级宽度用 layout CSS + `max-width`。
-
-## 禁止
-
-- 同一页面混用其他 UI 库。
-- 用 `MDropdown` 代替 Select 做枚举选择。
-- 手写 table/modal 替代 `MTable` / `MDialog`。
-
-完整清单：MCP `recommend_component`（含 recipe），或 skill `references/decision-recipes.md` / `component-index.md`。
+---
+description: Morya UI 组件用法与选型（Vue 业务代码）
+globs: src/**/*.vue
+alwaysApply: false
+---
+
+# 组件用法
+
+## 引入
+
+```ts
+import { MButton, MInput } from 'morya-ui'
+// 按需：import MButton from 'morya-ui/button'
+//        import 'morya-ui/button/style'
+```
+
+## 必选模式
+
+- 表单：`MForm` + `MFormItem` + 字段组件；提交用 `@submit` + `type="submit"`。
+- 表格：`MTable` 的 `columns` + `rows` + `row-key`；单元格用 `#cell-{key}` 插槽。没有 `data` prop。
+- 浮层：详情/编辑 `MDialog`；侧栏 `MDrawer`；删除确认 `MConfirmDialog`。
+- 反馈（**默认 Message**）：
+  - 单行操作结果 → `message.success/info/warn/error('…')`
+  - 有标题 + 详情 / 异步通知 → `toast.*({ summary, detail })`
+  - 表单区常驻错误 → 字段 `errorMessage`，或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主，不是内嵌 Alert）
+  - 详见 skill `references/feedback.md`
+
+## Props 约定
+
+- 尺寸：`size="small" | "large"`（默认 medium）。
+- 危险：`severity="danger"` 或 `invalid` + `errorMessage`。
+- 清除：优先 `clearable`（Select 亦支持 `showClear` 别名）。
+- 宽度：表单字段 `fluid`；页面级宽度用 layout CSS + `max-width`。
+
+## 禁止
+
+- 同一页面混用其他 UI 库。
+- 用 `MDropdown` 代替 Select 做枚举选择。
+- 手写 table/modal 替代 `MTable` / `MDialog`。
+
+完整清单：MCP `recommend_component`（含 recipe），或 skill `references/decision-recipes.md` / `component-index.md`。

package/template/.cursor/rules/design-system.mdc

@@ -1,17 +1,17 @@
----
-description: Morya UI 设计系统第一信源。生成或修改 UI 前必读 DESIGN.md。
-alwaysApply: true
----
-
-# Morya UI 设计系统
-
-1. **先读** 项目根目录 `DESIGN.md`。组件选型用 MCP `recommend_component`（含 recipe），或 skill `references/decision-recipes.md` / `component-index.md`。
-2. **只用** `morya-ui` 的 `M*` 组件；全局样式 `morya-ui/styles.css`。
-3. **颜色/间距/圆角** 使用 `--m-*` CSS 变量，禁止裸 hex/rgb（见 `scripts/check-raw-colors.mjs`）。
-4. **页面结构** 用 MCP `get_golden_page`（`list-page` / `form-page` / `form-in-dialog` / `detail-page` / `dashboard-page` / `login-page` / `landing-page` / `empty-state` / `result-page` / `settings-page` / `wizard-form`），不要发明新布局范式。
-5. **表单选项** 用 `MSelect` / `MTreeSelect`；**动作菜单** 用 `MDropdown`。
-6. 不确定 API 时查文档站或 MCP `get_component`，**禁止臆造 prop**；写完后必须 `validate_usage`。
-7. 根节点用 `MConfigProvider`；后台布局用 `MLayout` 系列。
-8. **操作反馈默认 `message` API**；仅 `summary + detail` 或异步通知用 `toast`；表单常驻错误用字段 `errorMessage` 或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主）。见 skill `references/feedback.md`。
-
-Token 参考：MCP `get_design_rules`（运行时以 `morya-ui/styles.css` 为准）
+---
+description: Morya UI 设计系统第一信源。生成或修改 UI 前必读 DESIGN.md。
+alwaysApply: true
+---
+
+# Morya UI 设计系统
+
+1. **先读** 项目根目录 `DESIGN.md`。组件选型用 MCP `recommend_component`（含 recipe），或 skill `references/decision-recipes.md` / `component-index.md`。
+2. **只用** `morya-ui` 的 `M*` 组件；全局样式 `morya-ui/styles.css`。
+3. **颜色/间距/圆角** 使用 `--m-*` CSS 变量，禁止裸 hex/rgb（见 `scripts/check-raw-colors.mjs`）。
+4. **页面结构** 用 MCP `get_golden_page` 对齐区块顺序与 API；**视觉方向**按参考样式 / 用户指定风格 / 提示词推断（`list_style_presets`：quiet、soft、dense、rail、studio、ink）。已安装 `frontend-design` / `impeccable` 时只加深审美与抛光，**不得**换组件库或推翻黄金结构。
+5. **表单选项** 用 `MSelect` / `MTreeSelect`；**动作菜单** 用 `MDropdown`。
+6. 不确定 API 时查文档站或 MCP `get_component`，**禁止臆造 prop**；写完后必须 `validate_usage`。
+7. 根节点用 `MConfigProvider`；后台布局用 `MLayout` 系列。
+8. **操作反馈默认 `message` API**；仅 `summary + detail` 或异步通知用 `toast`；表单常驻错误用字段 `errorMessage` 或 token 样式的 `role="alert"`（`<MMessage>` 只是 message 宿主）。见 skill `references/feedback.md`。
+
+Token / 风格 / companion：MCP `get_design_rules`、`list_style_presets`；skill `optional-companions.md`（运行时以 `morya-ui/styles.css` 为准）

package/template/.cursor/rules/page-layout.mdc

@@ -1,78 +1,97 @@
----
-description: 生成 Morya UI 业务页面（列表/表单/仪表盘）时的布局规范
-alwaysApply: false
----
-
-# 页面布局（Agent Requested）
-
-生成完整页面时，先确定类型并 **复制黄金样例结构**：
-
-| 类型 | MCP `get_golden_page` |
-| --- | --- |
-| 列表页 | `list-page` |
-| 表单页 | `form-page`（仅长表单 / 独立配置页） |
-| 列表内弹窗表单 | `form-in-dialog` |
-| 详情页 | `detail-page` |
-| 结果 / 阻断页 | `result-page` |
-| 设置页 | `settings-page` |
-| 分步向导 | `wizard-form` |
-| 仪表盘 | `dashboard-page` |
-| 登录页 | `login-page` |
-| 营销落地 | `landing-page` |
-| 空状态 | `empty-state` |
-
-## 列表内新建 / 编辑（默认）
-
-后台 CRUD **优先**：列表页 + `MDialog`（或 `MDrawer`）内 `MForm`，不要把「新建用户 / 编辑角色」做成单独路由，除非字段很多或多步骤。
-
-## 列表页区块顺序
-
-1. `MLayout fillViewport` + 可选 `MLayoutSider bordered`
-2. 侧栏 `MMenu`
-3. `MLayoutHeader` → `MBreadcrumb`
-4. `MLayoutContent` → `MPageContent`
-5. `MPageHeader`（页面标题 + `#actions` 主操作；视口内 **唯一** filled primary）
-6. `MPageFilters`（可选 `variant="filled"`、`collapsible` + `#advanced`；查询/重置用 secondary）
-7. 可选 `MPageFilterChips` + 可关闭 `MTag`（有已选条件时，放在筛选与表格之间）
-8. 可选 `MPageToolbar`（仅批量操作，**不要**页面标题）
-9. `MTable`（直接放置；`#empty` → `MEmpty`）
-10. 分页由 `MTable paginator` 或同级 `MPagination`
-11. 短新建/编辑：同页 `MDialog` + `MForm`
-
-## 表单页区块顺序
-
-1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
-2. `MPageContent width="narrow"`
-3. `MPageHeader`（标题 + 说明）
-4. `MPageSection variant="form"` → `MForm`
-5. `MPageSection variant="actions"`：保存（primary）+ 取消（secondary）
-
-## 仪表盘区块顺序
-
-1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
-2. `MPageContent density="spacious"` → `MPageHeader`
-3. KPI：`MGrid` + `MPageStat`（4 列或响应式）
-4. 主区两栏：`MCard shadow="always"` + `MEmpty`（图表未接入）/ 最近列表 `MTable`
-
-## 页面标准
-
-推荐实践（非强制），完整列表见 MCP `get_design_rules` → `standards`：
-
-| 主题 | 推荐 | 通常不必 |
-| --- | --- | --- |
-| 骨架 | `MLayout fillViewport` + `MPageContent` | `MLayoutContent` 再写 padding |
-| 区块 | `MPageFilters` / `MPageToolbar` / `MPageSection` | 手写 `.page-*`；`MCard` 再包一层 |
-| 列表表格 | `MTable` 直接放在 `MPageContent` | 用 `MCard` 再包 bordered 表格 |
-| 控件间距 | 同行用 `MSpace` / `MFlex`；区块靠 `MPageContent` gap | 外包 padded `div` 叠间距 |
-| 滚动 | 组件内置滚动壳用 `MScrollbar`；Dialog/Drawer 等内容留给业务 | 在用户内容区强行内置滚动 |
-| 颜色 | `--m-*` Token | 页面级 hex / 裸 rgb() |
-| 反馈 | 单行结果用 `message`；危险操作用 `MConfirmDialog` | 仅一行文案却用 toast |
-| 无障碍 | 图标按钮 `aria-label`、表单可见 label | — |
-
-仅允许控件宽度等局部 inline style（如筛选项 `width: 14rem`）。
-
-## MCP
-
-- 整页：`recommend_page` → `get_golden_page` → `get_design_rules`
-- 局部：`get_page_snippet`（如 `filters` / `toolbar` / `form-actions` / `scrollable-panel`）
-- 可选：`validate_page`（参考建议，不阻断）
+---
+description: 生成 Morya UI 业务页面（列表/表单/仪表盘）时的布局规范
+alwaysApply: false
+---
+
+# 页面布局（Agent Requested）
+
+生成完整页面时，先确定类型并 **复制黄金样例结构**：
+
+| 类型 | MCP `get_golden_page` |
+| --- | --- |
+| 列表页 | `list-page` |
+| 表单页 | `form-page`（仅长表单 / 独立配置页） |
+| 列表内弹窗表单 | `form-in-dialog` |
+| 详情页 | `detail-page` |
+| 结果 / 阻断页 | `result-page` |
+| 设置页 | `settings-page` |
+| 分步向导 | `wizard-form` |
+| 仪表盘 | `dashboard-page` |
+| 登录页 | `login-page` |
+| 营销落地 | `landing-page` |
+| 空状态 | `empty-state` |
+
+## 列表内新建 / 编辑（默认）
+
+后台 CRUD **优先**：列表页 + `MDialog`（或 `MDrawer`）内 `MForm`，不要把「新建用户 / 编辑角色」做成单独路由，除非字段很多或多步骤。
+
+## 列表页区块顺序
+
+1. `MLayout fillViewport` + 可选 `MLayoutSider bordered`
+2. 侧栏 `MMenu`
+3. `MLayoutHeader` → `MBreadcrumb`
+4. `MLayoutContent` → `MPageContent`（**仅在下方高度规则适用时**再加 `fill`）
+5. `MPageHeader`（页面标题 + `#actions` 主操作；视口内 **唯一** filled primary）
+6. `MPageFilters`（可选 `variant="filled"`、`collapsible` + `#advanced`；查询/重置用 secondary）
+7. 可选 `MPageFilterChips` + 可关闭 `MTag`（有已选条件时，放在筛选与表格之间）
+8. 可选 `MPageToolbar`（仅批量操作，**不要**页面标题）
+9. `MTable`（直接放置；`#empty` → `MEmpty`）
+10. 分页由 `MTable paginator` 或同级 `MPagination`
+11. 短新建/编辑：同页 `MDialog` + `MForm`
+
+### 列表高度 — 先判断，再决定是否 fill
+
+仅当 **多数** 条件成立时使用 `MPageContent fill` + `MTable fill paginator`：
+
+- 全视口后台列表（`MLayout fillViewport`），页面主任务就是浏览一张表
+- 表格按内容高度会留下大块空白、分页悬在中间不好看
+- 希望表体内部滚动、分页贴在页面最下方
+
+以下情况 **不要** 用 `fill`：
+
+- 嵌入/次要表格（仪表盘「最近」、详情关联表、Card 内）
+- 内容本身很短，内容高度表格即可
+- 整页应作为文档滚动（长筛选 + 说明 + 表格）
+- Dialog / Drawer 内表格
+- 表格不是中间唯一主区域的混合布局
+
+适合 `fill` 时不要手写 `min-height` / `calc`；不适合时不要硬套 `fill`。
+
+## 表单页区块顺序
+
+1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
+2. `MPageContent width="narrow"`
+3. `MPageHeader`（标题 + 说明）
+4. `MPageSection variant="form"` → `MForm`
+5. `MPageSection variant="actions"`：保存（primary）+ 取消（secondary）
+
+## 仪表盘区块顺序
+
+1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
+2. `MPageContent density="spacious"` → `MPageHeader`
+3. KPI：`MGrid` + `MPageStat`（4 列或响应式）
+4. 主区两栏：`MCard shadow="always"` + `MEmpty`（图表未接入）/ 最近列表 `MTable`
+
+## 页面标准
+
+推荐实践（非强制），完整列表见 MCP `get_design_rules` → `standards`：
+
+| 主题 | 推荐 | 通常不必 |
+| --- | --- | --- |
+| 骨架 | `MLayout fillViewport` + `MPageContent` | `MLayoutContent` 再写 padding |
+| 区块 | `MPageFilters` / `MPageToolbar` / `MPageSection` | 手写 `.page-*`；`MCard` 再包一层 |
+| 列表表格 | `MTable` 直接放 `MPageContent`；高度规则适用时再 `fill` | 用 `MCard` 再包 bordered 表格；不适合时硬套 `fill` |
+| 控件间距 | 同行用 `MSpace` / `MFlex`；区块靠 `MPageContent` gap | 外包 padded `div` 叠间距 |
+| 滚动 | 全视口主列表可表体滚动（`fill`）；否则 Layout / 局部 `MScrollbar` | 在用户内容区强行内置滚动；无理由双滚动条 |
+| 颜色 | `--m-*` Token | 页面级 hex / 裸 rgb() |
+| 反馈 | 单行结果用 `message`；危险操作用 `MConfirmDialog` | 仅一行文案却用 toast |
+| 无障碍 | 图标按钮 `aria-label`、表单可见 label | — |
+
+仅允许控件宽度等局部 inline style（如筛选项 `width: 14rem`）。
+
+## MCP
+
+- 整页：`recommend_page`（可传 `style`）→ `get_golden_page` → `get_design_rules` / `list_style_presets`
+- 风格：有参考则跟参考；否则按 `styleDirection` 或请用户从 quiet/soft/dense/rail/studio/ink 选
+- 局部：`get_page_snippet`（如 `filters` / `toolbar` / `form-actions` / `scrollable-panel`）
+- 可选：`validate_page`（参考建议，不阻断）

package/template/DESIGN.md

@@ -1,59 +1,59 @@
-# Morya UI 设计系统（AI 第一信源）
-
-> 生成或审查使用 `morya-ui` 的界面时，**必须先遵守本文**。  
-> 本文只写与页面类型无关的契约。某一类页面怎么拼、用哪个组件，见 `morya-ui-pages` skill 与 MCP，不要从本文推断出唯一布局。
-
-## 1. 设计原则
-
-1. **组件优先**：交互与布局使用库内 `M*`，不手写等价 DOM。
-2. **令牌优先**：颜色、间距、圆角、阴影、动效使用 `--m-*`；禁止裸 `#hex` / `rgb()`（`scripts/check-raw-colors.mjs` 可扫描）。
-3. **语义一致**：主操作 `severity="primary"`；破坏性操作用 `severity="danger"` 或确认。
-4. **可访问性**：控件有可访问名称；仅图标的按钮带 `aria-label`；浮层可键盘关闭。
-5. **单一事实源**：组件 API 以 MCP / 文档为准，禁止臆造 prop、event、slot。
-
-## 2. 应用根
-
-- 入口引入 `morya-ui/styles.css`（或按需子路径样式）。
-- 应用根使用 `MConfigProvider`，统一 locale、主题、密度与浮层挂载。
-- 外壳随场景选择，不要把侧栏后台当成所有页面的默认结构。
-
-## 3. 设计令牌（摘要）
-
-完整定义见 MCP `get_design_rules`。运行时以已安装的 `morya-ui/styles.css` 为准。
-
-| 用途 | 变量 |
-| --- | --- |
-| 页面背景 | `--m-color-surface` |
-| 正文 | `--m-color-text` |
-| 次要文字 | `--m-color-text-muted` |
-| 边框 | `--m-color-border` |
-| 品牌 / 链接 | `--m-color-primary` |
-| 错误 | `--m-color-danger` |
-| 区块间距 | `--m-space-4` / `--m-space-6` |
-| 圆角 / 阴影 | `--m-radius-md` / `--m-shadow-md` |
-| 动效时长 | `--m-motion-fast/normal/enter/exit` |
-| 进出场位移 / 缓动 | `--m-motion-distance` / `--m-motion-ease` |
-
-动效强度用 `useMotion`（`data-m-motion`：`full` / `reduced` / `none`），不跟随系统 `prefers-reduced-motion`；进出场预设用 `motion.transitions` / 组件 `transition`（见文档站「动效」）。
-
-## 4. 禁止项
-
-- 禁止同一界面混用第二套 UI 库。
-- 禁止业务 CSS 写死主题色；暗色须能随 `[data-theme="dark"]` 生效。
-- 禁止用不可聚焦的容器冒充按钮。
-- 禁止跳过样式入口。
-- 禁止把某一类页面的配方写成所有页面的默认结构。
-
-## 5. AI 工作流
-
-1. 读本文，确认契约。
-2. 加载 `morya-ui-pages`，由 skill 选定表面与布局；可选 companion 只补充视觉或无障碍，冲突时本文 + skill + MCP 优先。
-3. 用 MCP 查真实 API 与样例后再写代码。
-4. 完成后可运行 `pnpm check:colors`（若已配置）。
-
-## 6. 相关资源
-
-- 包：`morya-ui` · 样式：`morya-ui/styles.css`
-- 页面配方：`.agents/skills/morya-ui-pages/`（及 setup 时勾选的 companion）
-- 主题 API：`useTheme` / `useDensity` / `useMotion`
-- 动效预设：`createMoryaUI({ motion })`、`componentDefaults.*.transition`、浮层 `transition` prop；详情见文档 `/docs/motion`
+# Morya UI 设计系统（AI 第一信源）
+
+> 生成或审查使用 `morya-ui` 的界面时，**必须先遵守本文**。  
+> 本文只写与页面类型无关的契约。某一类页面怎么拼、用哪个组件，见 `morya-ui-pages` skill 与 MCP，不要从本文推断出唯一布局。
+
+## 1. 设计原则
+
+1. **组件优先**：交互与布局使用库内 `M*`，不手写等价 DOM。
+2. **令牌优先**：颜色、间距、圆角、阴影、动效使用 `--m-*`；禁止裸 `#hex` / `rgb()`（`scripts/check-raw-colors.mjs` 可扫描）。
+3. **语义一致**：主操作 `severity="primary"`；破坏性操作用 `severity="danger"` 或确认。
+4. **可访问性**：控件有可访问名称；仅图标的按钮带 `aria-label`；浮层可键盘关闭。
+5. **单一事实源**：组件 API 以 MCP / 文档为准，禁止臆造 prop、event、slot。
+
+## 2. 应用根
+
+- 入口引入 `morya-ui/styles.css`（或按需子路径样式）。
+- 应用根使用 `MConfigProvider`，统一 locale、主题、密度与浮层挂载。
+- 外壳随场景选择，不要把侧栏后台当成所有页面的默认结构。
+
+## 3. 设计令牌（摘要）
+
+完整定义见 MCP `get_design_rules`。运行时以已安装的 `morya-ui/styles.css` 为准。
+
+| 用途 | 变量 |
+| --- | --- |
+| 页面背景 | `--m-color-surface` |
+| 正文 | `--m-color-text` |
+| 次要文字 | `--m-color-text-muted` |
+| 边框 | `--m-color-border` |
+| 品牌 / 链接 | `--m-color-primary` |
+| 错误 | `--m-color-danger` |
+| 区块间距 | `--m-space-4` / `--m-space-6` |
+| 圆角 / 阴影 | `--m-radius-md` / `--m-shadow-md` |
+| 动效时长 | `--m-motion-fast/normal/enter/exit` |
+| 进出场位移 / 缓动 | `--m-motion-distance` / `--m-motion-ease` |
+
+动效强度用 `useMotion`（`data-m-motion`：`full` / `reduced` / `none`），不跟随系统 `prefers-reduced-motion`；进出场预设用 `motion.transitions` / 组件 `transition`（见文档站「动效」）。
+
+## 4. 禁止项
+
+- 禁止同一界面混用第二套 UI 库。
+- 禁止业务 CSS 写死主题色；暗色须能随 `[data-theme="dark"]` 生效。
+- 禁止用不可聚焦的容器冒充按钮。
+- 禁止跳过样式入口。
+- 禁止把某一类页面的配方写成所有页面的默认结构。
+
+## 5. AI 工作流
+
+1. 读本文，确认契约。
+2. 加载 `morya-ui-pages`，由 skill 选定表面与布局；可选 companion 只补充视觉或无障碍，冲突时本文 + skill + MCP 优先。
+3. 用 MCP 查真实 API 与样例后再写代码。
+4. 完成后可运行 `pnpm check:colors`（若已配置）。
+
+## 6. 相关资源
+
+- 包：`morya-ui` · 样式：`morya-ui/styles.css`
+- 页面配方：`.agents/skills/morya-ui-pages/`（及 setup 时勾选的 companion）
+- 主题 API：`useTheme` / `useDensity` / `useMotion`
+- 动效预设：`createMoryaUI({ motion })`、`componentDefaults.*.transition`、浮层 `transition` prop；详情见文档 `/docs/motion`

package/template/scripts/check-raw-colors.mjs

@@ -1,74 +1,74 @@
-#!/usr/bin/env node
-/**
- * Scan source files for raw color literals outside design-tokens/ and theme/.
- * Usage: node scripts/check-raw-colors.mjs [dir...]
- * Exit 1 if violations found.
- */
-import { readdirSync, readFileSync, statSync } from 'node:fs'
-import path from 'node:path'
-
-const roots = process.argv.slice(2).length ? process.argv.slice(2) : ['src']
-const IGNORE_DIRS = new Set(['node_modules', 'dist', 'coverage', 'design-tokens', 'theme', '.git'])
-const EXT = new Set(['.vue', '.css', '.scss', '.ts', '.tsx', '.js', '.jsx'])
-
-const HEX = /#[0-9a-f]{3,8}\b/gi
-const RGB = /\brgb\s*\(/g
-const HSL = /\bhsl\s*\(/g
-
-/** Allow transparent, currentColor, inherit in CSS values */
-const ALLOW_LINE = /var\s*\(\s*--m-|color-mix\s*\(|transparent|currentColor|inherit|none/
-
-/** Skip demo IDs like '#1024' or 'WO-1024' in script/template strings */
-const DEMO_ID = /['"]#?[A-Z0-9-]{2,}['"]/
-
-const violations = []
-
-function walk(dir) {
-  for (const name of readdirSync(dir)) {
-    const full = path.join(dir, name)
-    const st = statSync(full)
-    if (st.isDirectory()) {
-      if (IGNORE_DIRS.has(name)) continue
-      walk(full)
-      continue
-    }
-    const ext = path.extname(name)
-    if (!EXT.has(ext)) continue
-    const normalized = full.replace(/\\/g, '/')
-    if (normalized.includes('design-tokens/') || normalized.includes('/theme/')) continue
-    if (normalized.includes('.test.') || normalized.includes('/__tests__/')) continue
-
-    const text = readFileSync(full, 'utf8')
-    const lines = text.split(/\r?\n/)
-    lines.forEach((line, index) => {
-      if (ALLOW_LINE.test(line)) return
-      if (DEMO_ID.test(line)) return
-      if (HEX.test(line) || RGB.test(line) || HSL.test(line)) {
-        HEX.lastIndex = 0
-        RGB.lastIndex = 0
-        HSL.lastIndex = 0
-        violations.push({ file: full, line: index + 1, text: line.trim() })
-      }
-    })
-  }
-}
-
-for (const root of roots) {
-  try {
-    walk(path.resolve(root))
-  } catch (error) {
-    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') continue
-    throw error
-  }
-}
-
-if (violations.length) {
-  console.error(`Found ${violations.length} raw color literal(s). Use --m-* tokens instead:\n`)
-  for (const v of violations) {
-    console.error(`  ${v.file}:${v.line}`)
-    console.error(`    ${v.text}\n`)
-  }
-  process.exit(1)
-}
-
-console.log('No raw color literals found.')
+#!/usr/bin/env node
+/**
+ * Scan source files for raw color literals outside design-tokens/ and theme/.
+ * Usage: node scripts/check-raw-colors.mjs [dir...]
+ * Exit 1 if violations found.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs'
+import path from 'node:path'
+
+const roots = process.argv.slice(2).length ? process.argv.slice(2) : ['src']
+const IGNORE_DIRS = new Set(['node_modules', 'dist', 'coverage', 'design-tokens', 'theme', '.git'])
+const EXT = new Set(['.vue', '.css', '.scss', '.ts', '.tsx', '.js', '.jsx'])
+
+const HEX = /#[0-9a-f]{3,8}\b/gi
+const RGB = /\brgb\s*\(/g
+const HSL = /\bhsl\s*\(/g
+
+/** Allow transparent, currentColor, inherit in CSS values */
+const ALLOW_LINE = /var\s*\(\s*--m-|color-mix\s*\(|transparent|currentColor|inherit|none/
+
+/** Skip demo IDs like '#1024' or 'WO-1024' in script/template strings */
+const DEMO_ID = /['"]#?[A-Z0-9-]{2,}['"]/
+
+const violations = []
+
+function walk(dir) {
+  for (const name of readdirSync(dir)) {
+    const full = path.join(dir, name)
+    const st = statSync(full)
+    if (st.isDirectory()) {
+      if (IGNORE_DIRS.has(name)) continue
+      walk(full)
+      continue
+    }
+    const ext = path.extname(name)
+    if (!EXT.has(ext)) continue
+    const normalized = full.replace(/\\/g, '/')
+    if (normalized.includes('design-tokens/') || normalized.includes('/theme/')) continue
+    if (normalized.includes('.test.') || normalized.includes('/__tests__/')) continue
+
+    const text = readFileSync(full, 'utf8')
+    const lines = text.split(/\r?\n/)
+    lines.forEach((line, index) => {
+      if (ALLOW_LINE.test(line)) return
+      if (DEMO_ID.test(line)) return
+      if (HEX.test(line) || RGB.test(line) || HSL.test(line)) {
+        HEX.lastIndex = 0
+        RGB.lastIndex = 0
+        HSL.lastIndex = 0
+        violations.push({ file: full, line: index + 1, text: line.trim() })
+      }
+    })
+  }
+}
+
+for (const root of roots) {
+  try {
+    walk(path.resolve(root))
+  } catch (error) {
+    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') continue
+    throw error
+  }
+}
+
+if (violations.length) {
+  console.error(`Found ${violations.length} raw color literal(s). Use --m-* tokens instead:\n`)
+  for (const v of violations) {
+    console.error(`  ${v.file}:${v.line}`)
+    console.error(`    ${v.text}\n`)
+  }
+  process.exit(1)
+}
+
+console.log('No raw color literals found.')