@morya-ui/setup 0.3.8 → 0.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/setup",
   "type": "module",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "description": "One-shot setup for morya-ui: install the library, multi-editor MCP, Agent skills, and design config.",
   "license": "MIT",
   "homepage": "https://github.com/morya-space/morya-ui/tree/main/packages/setup#readme",

package/template/.agents/skills/morya-ui-pages/references/component-index.md

@@ -22,7 +22,7 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 
 ## Forms · inputs
 
-`MForm`, `MFormItem`, `MInput`, `MInputPassword`, `MInputNumber`, `MTextarea`, `MInputOtp`, `MInputColor`, `MInputGroup`, `MInputTags`, `MSelect`, `MTreeSelect`, `MCascadeSelect`, `MListbox`, `MSelectButton`, `MDatePicker`, `MAutoComplete`, `MCheckbox` / `MCheckboxGroup`, `MRadio` / `MRadioGroup`, `MSwitch`, `MToggleButton`, `MSlider`, `MRating`, `MKnob`, `MFileUpload`, `MFloatLabel`, `MIconField`, `MLabel`
+`MForm` / `MFormItem` / `MFormList`, `MInput`, `MInputPassword`, `MInputNumber`, `MTextarea`, `MInputOtp`, `MInputColor`, `MInputGroup`, `MInputTags`, `MMentions`, `MSelect`, `MTreeSelect`, `MCascadeSelect`, `MListbox`, `MSelectButton`, `MDatePicker`, `MTimePicker`, `MCalendar`, `MAutoComplete`, `MCheckbox` / `MCheckboxGroup`, `MRadio` / `MRadioGroup`, `MSwitch`, `MToggleButton`, `MSlider`, `MRating`, `MKnob`, `MFileUpload`, `MFloatLabel`, `MIconField`, `MLabel`
 
 ## Layout helpers
 
@@ -30,7 +30,7 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 
 ## Data
 
-`MTable` (`columns` + **`rows`**, not `data`; optional `virtual`, `resizable`/`filterable`, `children`, `span-method`, `tree-config`), `MDataView`, `MTree`, `MPagination`, `MOrderList`, `MPickList`, `MStatus` / `MTag` / `MChip` / `MBadge`, `MAvatar` / `MAvatarGroup`, `MTimeline`, `MMeterGroup`, `MVirtualScroller`
+`MTable` (`columns` + **`rows`**, not `data`; optional `virtual`, `resizable`/`filterable`, `children`, `span-method`, `tree-config`), `MDataView`, `MList` / `MListItem` / `MListItemMeta`, `MTree`, `MPagination`, `MOrderList`, `MPickList`, `MDescriptions`, `MStatistic`, `MStatus` / `MTag` / `MChip` / `MBadge`, `MAvatar` / `MAvatarGroup`, `MTimeline`, `MMeterGroup`, `MVirtualScroller`
 
 ## Feedback
 
@@ -40,6 +40,7 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 | `toast` | `summary` + `detail`, or async / background feel | `feedback-choice` |
 | `<MMessage>` | Optional host for the `message` service. **Not** an inline alert | `feedback-choice` |
 | field `errorMessage` or token `role="alert"` | Persistent form / auth error | `feedback-choice` |
+| `MAlert` | Persistent in-page notice (not a toast) | `feedback-choice` |
 | `MEmpty` | No-data / first-use / filtered empty | `empty-result-choice` |
 | `MResult` | Terminal outcome: success, failure, 403 / 404 / 500 | `empty-result-choice` |
 | `MLoading` / `v-loading` / `loading.service` | **Default** region or fullscreen loading mask | `loading-choice` |
@@ -50,11 +51,11 @@ Full API: docs site `/components` or MCP (`get_component`, `search`, `validate_u
 
 ## Overlays & menus
 
-`MDialog`, `MDrawer`, `MConfirmDialog` / `MConfirmPopup`, `MPopover`, `MTooltip`, `MDropdown` (**actions only**), `MContextMenu`, `MCommandMenu`, `MMenu` / `MMenubar` / `MTieredMenu` / `MMegaMenu`, `MTabs`, `MStepper`
+`MDialog`, `MDrawer`, `MConfirmDialog` / `MConfirmPopup`, `MPopover`, `MTooltip`, `MDropdown` (**actions only**), `MContextMenu`, `MCommandMenu`, `MMenu` / `MMenubar` / `MTieredMenu` / `MMegaMenu`, `MTabs`, `MStepper`, `MTour`, `MAffix`, `MAnchor`
 
 ## Surfaces / media
 
-`MCard`, `MPanel`, `MAccordion`, `MCarousel`, `MGallery`, `MIcon`, `MScrollbar`, `MInplace`, `MScrollTop`, `MTerminal`
+`MCard`, `MPanel`, `MAccordion`, `MCarousel`, `MGallery`, `MImage`, `MIcon`, `MQRCode`, `MScrollbar`, `MInplace`, `MScrollTop`, `MTerminal`, `MTypography` / `MTitle` / `MText` / `MParagraph` / `MLink`, `MWatermark`
 
 ## Scenario → decision
 

package/template/.agents/skills/morya-ui-pages/references/decision-recipes.md

@@ -1308,7 +1308,7 @@ This file is the **offline** mirror for agents without MCP.
 **Recipe · props**
 
 - title + description
-- icon 或 illustration 按需（默认即可）
+- 主区域优先 illustration（no-content / no-result…）
 - 表格内放在 #empty
 
 **Recipe · slots**

package/template/.agents/skills/morya-ui-pages/references/page-layouts.md

@@ -9,7 +9,7 @@ Golden pages are **assembly demos / structure baselines**, not the default clone
 | List | List page | `list-page` (`list-page-dense` / `list-page-rail` craft only) | `layout-app-shell`, `page-header-actions`, **`list-filters-stack`** (dense → `list-filters-dense`), `list-table`, `form-in-dialog`, `confirm-delete` |
 | Form (long / dedicated) | Form page | `form-page` | `page-content-form`, `form-header`, `form-body`, `form-actions` |
 | List create/edit dialog | List create/edit dialog | `form-in-dialog` | **`form-in-dialog`** (preferred) |
-| Detail | Detail page | `detail-page` | `detail-toolbar`, `form-in-dialog` |
+| Detail | Detail page | `detail-page` | `detail-toolbar`, `detail-descriptions`, `form-in-dialog` |
 | Dashboard | Dashboard | `dashboard-page` | `dashboard-kpi-grid`, `dashboard-chart-card`, `dashboard-recent-table` |
 | Login | — (see [surfaces.md](surfaces.md)) | `login-page` | **`auth-split-shell`** |
 | Landing | — (see [surfaces.md](surfaces.md)) | `landing-page` | — |
@@ -74,8 +74,10 @@ Craft: [visual-craft.md](visual-craft.md) § Ops polish.
 
 1. `MLayout fillViewport` → `MLayoutHeader` → `MBreadcrumb`
 2. `MPageContent density="spacious"` → `MPageHeader` (title + short domain description when useful)
-3. KPI row: `MGrid` + `MPageStat` (4 columns or responsive) — `dashboard-kpi-grid`
-4. Main split: `MCard shadow="always"` + `MEmpty` (chart pending) and/or recent `MTable` — `dashboard-chart-card` / `dashboard-recent-table`
+3. Optional `MAlert` for ops tip / degraded dependency (dismissible when appropriate)
+4. KPI row: `MGrid` + **`MPageStat`** (trend + icon) — `dashboard-kpi-grid`
+5. Main split: `MCard shadow="always"` + **`MEmpty illustration`** (chart pending) and/or recent `MTable` / `MList` — `dashboard-chart-card` / `dashboard-recent-table`
+6. Plain numeric callouts inside a card (no trend UI) → `MStatistic`, not a second custom KPI CSS
 
 Craft: spacious density + Ops polish; do not turn the first viewport into a marketing hero.
 
@@ -89,7 +91,7 @@ Craft: spacious density + Ops polish; do not turn the first viewport into a mark
 | Spacing | `MSpace` / `MFlex` for peers; page gap from `MPageContent` | Nested padded divs stacking gaps |
 | Scroll | Full-viewport main lists may use table-body scroll via `fill`; otherwise layout / local `MScrollbar` | Forcing overflow on every content slot; stacked page + table scrollbars without reason |
 | Color | `--m-*` | Page-level hex / rgb |
-| Feedback | One-line → `message`; danger → confirm dialog | Toast for a single short string |
+| Feedback | One-line → `message`; danger → confirm dialog; sticky page tip → `MAlert` | Toast for a single short string |
 | A11y | Labels + icon `aria-label` | Unlabeled icon controls |
 
 Inline style is acceptable for control widths (e.g. filter `width: 14rem`).
@@ -98,9 +100,10 @@ Inline style is acceptable for control widths (e.g. filter `width: 14rem`).
 
 1. Same admin chrome as list (breadcrumb → `MPageContent`)
 2. `MPageHeader` — title, `MStatus` in `#actions`, primary/secondary/danger → `detail-toolbar`
-3. Summary `MPageSection` + property `MCard` (definition grid with `--m-*` only)
-4. Related data: `MCard` + `MTable` / tabs / timeline
-5. Short edit → `form-in-dialog`; long edit → form page / `form-in-drawer`
+3. Summary chips optional (`MTag`) — keep quiet
+4. **Attributes** → `MDescriptions` / `MDescriptionsItem` (bordered when comparing many fields) — `detail-descriptions`
+5. Related activity: prefer `MList` + `MListItemMeta` for narrative feeds; `MTable` when columns matter
+6. Short edit → `form-in-dialog`; long edit → form page / `form-in-drawer`
 
 ## List create/edit dialog — block order
 

package/template/.agents/skills/morya-ui-pages/references/surfaces.md

@@ -9,7 +9,7 @@ Pick a lane, then a surface. Prefer project golden pages for **Ops**; use the re
 | List | Scan, filter, act on many rows | Golden list + [page-layouts.md](page-layouts.md); **create/edit with ≤~8 fields → `MDialog` on the list** |
 | Form | Create / edit one entity as a **dedicated page** | Golden form — only when multi-section, many fields, or user asked for an independent form route |
 | Dashboard | Orient + jump to work | Golden dashboard |
-| Detail | Read-heavy record + secondary actions | `MPageHeader` + sections via `MCard`/`MPageSection`; edit via `MDialog` / `MDrawer` (prefer over a second form route) |
+| Detail | Read-heavy record + secondary actions | `MPageHeader` + **`MDescriptions`** for attributes; related feed via `MList` or `MTable`; edit via `MDialog` / `MDrawer` |
 | Settings | Grouped preferences | Narrow `MPageContent` + stacked `MPageSection` / `MTabs` + `MForm` |
 | Hybrid list | List + drawer/dialog | **Default Ops CRUD pattern**: list golden + `MDialog`/`MDrawer` form |
 
@@ -17,7 +17,7 @@ Pick a lane, then a surface. Prefer project golden pages for **Ops**; use the re
 
 | Surface | Job | Recipe |
 | --- | --- | --- |
-| Login / register | Authenticate with trust | Golden: MCP `get_golden_page` `login-page` — split brand + `MForm` (`MInput`, `MInputPassword`); form-level errors via token `role="alert"` (not Toast). Brand wash: [visual-craft.md](visual-craft.md) § Atmosphere |
+| Login / register | Authenticate with trust | Golden: MCP `get_golden_page` `login-page` — split brand + `MForm`; prefer `MConfigProvider input-variant="filled"`; optional `themeConfig` for brand seed; failures via `role="alert"` / `errorMessage` (not Toast). Brand wash: [visual-craft.md](visual-craft.md) § Shell recipes |
 | Invite / accept | Join org | Same shell; show org name clearly |
 | Forgot / reset | Recover access | Short form + success state with next step |
 | Profile / account | Edit self | Settings-like sections; avatar via `MAvatar` |
@@ -28,8 +28,8 @@ Keep credential forms quiet: one primary CTA, clear labels, no decorative noise
 
 | Surface | Job | Recipe |
 | --- | --- | --- |
-| Empty state | Invite first action | Golden: MCP `get_golden_page` `empty-state` — `MEmpty` + primary/secondary `MButton` in `#extra`; dashed shell + radial wash from visual-craft |
-| Onboarding | Teach the product path | `MStepper` or paced cards; one decision per step; finish → Ops home |
+| Empty state | Invite first action | Golden: MCP `get_golden_page` `empty-state` — `MEmpty` + **`illustration`** (`no-content` / `no-result` / …) + primary/secondary in `#extra` |
+| Onboarding | Teach the product path | `MStepper` or paced cards; optional `MTour` for in-app spotlight; one decision per step; finish → Ops home |
 | Wizard | Multi-step create | `MStepper` + `MForm` per step + sticky actions (`上一步` / `下一步` / `提交`) |
 | Success / result | Confirm completion | `MResult status="success"` / `error` + `#footer` next actions (`查看详情` / `返回列表`); same shell idea as `result-page` |
 
@@ -51,7 +51,7 @@ Use when the brief is landing, pricing, launch, or docs marketing — **not** fo
 
 | Surface | Job | Recipe |
 | --- | --- | --- |
-| Landing | Convert / explain product | Golden: MCP `get_golden_page` `landing-page` — one-job hero; CTAs → `MButton`; chips → `MTag`; FAQ → `MAccordion` |
+| Landing | Convert / explain product | Golden: MCP `get_golden_page` `landing-page` — one-job hero; CTAs → `MButton`; chips → `MTag`; FAQ → `MAccordion`; prefer `MTypography` / `MTitle` / `MParagraph` for hierarchy when available |
 | Pricing | Choose a plan | Clear plan cards (`MCard`) + primary CTA; highlight recommended plan without clutter |
 | Feature showcase | Prove capability | Alternating media/copy; live `M*` demo only if lightweight |
 | Docs marketing chrome | Frame documentation | Header + nav using `M*` where suitable; content area stays readable |

package/template/.agents/skills/morya-ui-pages/references/visual-craft.md

@@ -48,13 +48,32 @@ If the plan looks like any-SaaS (purple wash, cream serif, neon glow) and the us
 3. **Status** → `MStatus`; `MTag` for categories/filters only.
 4. **Row actions** — text / outlined / small.
 5. **Filter rhythm** — search ~`14rem`, selects ~`10–12rem`.
-6. **Empty** — `MEmpty` with next action.
+6. **Empty** — `MEmpty` with domain next-step copy + **one** primary in `#extra`. Prefer `illustration` (`no-content` / `no-result` / `no-message` / `network-error` / …) over a generic icon when the empty is a main region.
 7. **No extra cards** around filters/table “for polish”.
 8. **Domain copy**.
 9. **Density** — follow user cues (`compact` / spacious); don’t invent a second scale.
 10. **Quiet chrome** — no marketing heroes / glow unless the user asked.
+11. **Page alerts** — persistent in-page notices → `MAlert` (not Toast, not `<MMessage>` as markup).
+12. **Detail fields** — attribute grids → `MDescriptions` / `MDescriptionsItem` (not hand-rolled `<dl>`).
+13. **Plain metrics** — numbers without trend chrome → `MStatistic` inside a section/card; KPI strips with trend → keep `MPageStat`.
+14. **Activity / feed rows** — same-shape items without dense columns → `MList` + `MListItem` / `MListItemMeta`; tabular compare → `MTable`.
 
-Ops beauty = alignment + semantics + restraint, **not** gradients.
+Ops beauty = alignment + semantics + restraint + the right `M*` for the job, **not** gradients.
+
+## Component craft map (post-library upgrades)
+
+| Need | Prefer | Avoid |
+| --- | --- | --- |
+| Admin KPI with trend | `MPageStat` (`dashboard-kpi-grid`) | Custom stat CSS |
+| Inline / detail number | `MStatistic` | Fake big numbers with raw `<p>` |
+| Detail attribute grid | `MDescriptions` (`detail-descriptions`) | Hand-written `<dl>` / nested tables |
+| Lightweight feed | `MList` + Meta | Forcing a full `MTable` for 3–5 narrative rows |
+| Empty main region | `MEmpty` + `illustration` | “暂无数据” + bare icon only |
+| In-page notice | `MAlert` | Toast for sticky page tips |
+| Auth / form inputs | `MConfigProvider input-variant="filled"` (or filled controls) | Mixing outlined/filled without reason |
+| Brand seed | `themeConfig` / project theme CSS | Page-level hex |
+| Express headings | `MTypography` / `MTitle` / `MParagraph` where it helps hierarchy | Second font kit |
+| First-run teach | `MTour` after empty/onboarding | Modal essay walls |
 
 ## Anti-default looks
 

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

@@ -18,6 +18,12 @@ 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/
 
+/** Theme seed / createTheme brand inputs must be concrete colors. */
+const ALLOW_THEME_SEED = /\bcolorPrimary\s*:|\bseed\s*:\s*\{[^}]*colorPrimary/
+
+/** Canvas / encoder fallbacks that must stay concrete for off-DOM drawing. */
+const ALLOW_CANVAS_FALLBACK = /rgb\(\s*0\s*,\s*0\s*,\s*0\s*\)|rgb\(\s*255\s*,\s*255\s*,\s*255\s*\)/
+
 /** Skip demo IDs like '#1024' or 'WO-1024' in script/template strings */
 const DEMO_ID = /['"]#?[A-Z0-9-]{2,}['"]/
 
@@ -28,7 +34,7 @@ function walk(dir) {
     const full = path.join(dir, name)
     const st = statSync(full)
     if (st.isDirectory()) {
-      if (IGNORE_DIRS.has(name)) continue
+      if (IGNORE_DIRS.has(name) || name === 'demos') continue
       walk(full)
       continue
     }
@@ -36,12 +42,15 @@ function walk(dir) {
     if (!EXT.has(ext)) continue
     const normalized = full.replace(/\\/g, '/')
     if (normalized.includes('design-tokens/') || normalized.includes('/theme/')) continue
+    if (normalized.includes('/docs/demos/')) 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 (ALLOW_THEME_SEED.test(line)) return
+      if (ALLOW_CANVAS_FALLBACK.test(line)) return
       if (DEMO_ID.test(line)) return
       if (HEX.test(line) || RGB.test(line) || HSL.test(line)) {
         HEX.lastIndex = 0