morya-ui 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -1,775 +1,786 @@
-# morya-ui
-
-## 0.4.3
-
-### 修复
-
-- Button pt 类型与 PageFilters 文案插空
-
-### 变更
-
-- 语义色 severity 统一为 type
-- add ConfigProvider styles import
-
-## 0.4.2
-
-### 新功能
-
-- add MTable component and support column align props and scroll height settings
-
-### 修复
-
-- align loading, defaults, and outlined active styles
-- MMessage component icon align center
-
-### 文档
-
-- clarify ButtonGroup as visual-only grouping
-- tighten public docs and reorder demos
-- sync demos and MCP after dual-axis API
-
-### 变更
-
-- remove built-in badge API
-- tokenize styles against theme tokens
-- update button props and remove severity prop
-
-## Unreleased
-
-### 破坏性变更
-
-- **Button**：改为 `type` / `color` × `variant` 双轴 API
-  - 新增 `type` 语法糖（`default` / `primary` / `dashed` / `link` / `text`）与 `color` × `variant`
-  - 删除 `severity`；危险色改用 `danger` / `color="danger"`
-  - `fluid` → `block`；`nativeType` → `htmlType`；`iconPos` → `iconPlacement`
-  - 删除内置 `badge` / `badgeColor`；角标请用 `MBadge` 包裹按钮
-  - 支持 `href` / `ghost` / `loading` 对象形态与 `pt`
-- **语义色 prop**：Badge / Tag / Chip / Status / Alert / Message / Toast 等将 `severity` 统一为 `type`
-  - `warn` → `warning`；Alert / Message / Toast 失败态 `error` → `danger`
-  - 共享类型改为 `MToneType` / `MTagType` / `MToastType`（不再导出 `MSeverity`）
-
-### 修复
-
-- **Button**：loading 时不再误加原生 `disabled`（避免灰掉主色）
-- **Button**：`shape` / `ripple` / `press` 正确继承 `componentDefaults`，本地可覆盖
-- **Button**：`:active` 同步边框与文字色；默认 outlined / dashed 按下保持表面色背景
-
-### 文档
-
-- 补齐 Button 文档 demo：ColorVariant / Icon / Size / Ghost / Danger / Block / RipplePress
-- 同步 MCP catalog、setup / design-kit 约定，以及 `morya-ui-pages` skill 中的 Button API
-
-## 0.4.1
-
-### 破坏性变更
-
-- rewrite public component API
-
-### 新功能
-
-- ability to add transparent root node attributes to multiple components
-
-### 修复
-
-- components name change
-- ensure single root vnode for Transition classes and update design tokens
-
-### 文档
-
-- add components pt attr
-- refresh demos for effects, multi-view, and vertical
-
-### 变更
-
-- update component library
-- unify focus and hover states across components
-- sync MCP catalog and design tokens for Carousel
-- standardize import statements across components and update styles
-
-## 0.4.0
-
-### 新功能
-
-- wire filled variant and allow null model values
-- add eight additional locale packs
-- add thin DatePicker time wrapper
-- add a notification API and richer messages
-- add an imperative modal API
-- add a 24-column flex grid with responsive Row/Col
-- add a controlled form instance, nested fields and FormList
-- add copyable, editable and multi-line ellipsis
-- add copy, edit and field validation messages
-- support theme overrides, global disabled and RTL
-- add a seed-driven token derivation engine
-- add MList with meta rows and pagination
-- add MCalendar with fullscreen and range guards
-- add Segmented, Mentions, and Statistic
-- add Affix, Anchor, Tour, Watermark, and QRCode
-- deepen Dialog, Progress, Loading, and docs tone
-- polish Tag density and Table filter summary
-- deepen Form, inputs, and Select status handling
-- deepen Breadcrumb, Dropdown, Pagination, Stepper, Tabs
-- deepen Divider, Flex, Splitter, Space, and Layout
-- expand type coverage for time and ranges
-- add dashed variant, shapes, and float polish
-- add MTitle, MText, MParagraph, and MLink
-- add MImage with click-to-preview group
-- add MDescriptions and MDescriptionsItem
-- add MAlert for persistent in-page notices
-- refresh default tokens for enterprise visual feel
-
-### 修复
-
-- allow FormList initialValue factories and document FormList
-- add missing tokens and tokenize Button active color
-- unblock typecheck and map morya-ui to source
-- tile the overlay at the real pattern size
-- repair an invalid byte in the base stylesheet comment
-
-### 文档
-
-- repair List docs and restore corrupted Chinese API pages
-- clear remaining component API docs drift
-- cut List/Page/Grid docs drift and harden the auditor
-- add TimePicker events table and improve drift audits
-- drop when-to-use sections that restate the description
-- restructure navigation and add recipe walkthroughs
-- remove boilerplate tip from when-to-use sections
-- drop third-party parity references from docs and code
-- add design specs, mapping and theme editor
-- backfill when-to-use sections
-- add nested options demo
-- add conventions page for naming and feedback vocabulary
-
-### 变更
-
-- normalize double-spaced sources and CSS file headers
-- cut false positives in the API auditor
-- add typecheck and unit-test gates; fix Vitest includes
-- add size, docs-smoke and visual quality gates
-- export and register the new components
-- export and register new enterprise components
-
-## 0.3.8
-
-### 新功能
-
-- enhance agent skill management and documentation
-- 新增 `MAlert`：页面内嵌常驻提示（severity / closable / banner / action）
-- `MDatePicker` 扩展 `type`：`datetime` / `datetimerange` / `time` / `month` / `year`，并支持 `showSeconds`
-- 新增 `MList` / `MListItem` / `MListItemMeta`（`items` + Meta + 分页 / grid）
-- 新增 `MDescriptions` / `MDescriptionsItem`
-- 新增 `MImage` / `MImagePreviewGroup`（点击预览）
-- 新增 `MTypography`（`MTitle` / `MText` / `MParagraph` / `MLink`）
-- 按钮补齐 `variant="dashed"` / `shape`、描边默认态、字重 400、disabled 灰底；通栏用 `fluid`
-- 布局：`Divider` plain/size/orientation、`Flex` `gap` 别名、`Splitter` min2、sider 折叠宽 token 默认 80px
-- 导航：Breadcrumb `href`、Pagination `size`/`showSizeChanger`、Stepper `status`/`size`、Tabs `size`/`centered`、Dropdown `disabled`
-- 数据展示：`MTag` 密度与 `checkable`；`MTable` `size` 单元格 padding
-- 反馈：Dialog `maskClosable`/`centered`、ProgressBar `exception`/`active`、Loading/ProgressSpinner `tip`
-- 表单：Form `requiredMark` 别名 / `scrollToField` / `scrollToFirstError` / `size` 继承；输入类 `allowClear` 与 `status`；Select `status`；`--m-focus-shadow-warning`
-- 新增 `MAffix` / `MWatermark` / `MQRCode`（固钉 / 水印 / 二维码与状态遮罩）
-- 新增 `MAnchor` / `MAnchorLink`、`MTour`（`v-model:open` / `v-model:current`）
-- 新增 `MStatistic` / `MStatisticCountdown`
-- 新增 `MSegmented`（`options` / `block` / `shape` / `size`，`radiogroup` 键盘）
-- 新增 `MMentions`（`prefix` / `split` / 建议插入 / `@select`）
-- 新增 `MCalendar`（`fullscreen` / `showWeek` / `validRange` / `#dateCell` / `#header`）
-- `MTour` 键盘漫游 + `gap`；`MMentions` `allowClear` / `loading`；`MWatermark` overlay 防误删重绘；`MQRCode` `#statusRender`
-- `MTable` 表头筛选清除/确认分离、页脚合计与虚拟滚动约束提示
-
-### 变更
-
-- 默认主题：主色 `#1677FF`、中性字色/描边、控件高度 medium `32px`、控件圆角 `6px`、卡片圆角 `8px`、多层投影与更实的聚焦环
-- 字体栈改为系统无衬线；控件标签/表头/页签字重 500（页面标题仍 600）；动效 ease-out + 位移 `0.5rem`
-- 禁用态优先 `--m-color-text-disabled` / `--m-color-bg-disabled`，输入与页签等不再只靠 opacity
-- Pagination 默认尺寸由固定 small 改为 `size="medium"`（可用 `size` 调整）
-- `MTag` 默认字重 400、水平内边距约 8px，描边改为真实 `border`（保留透明边框占位）
-
-### 文档
-
-- 指南新增「约定」：命名、`severity` / `variant`、反馈与布局词表
-
-## 0.3.7
-
-### 新功能
-
-- add tree mode, instance APIs, and drop cell editing
-- enhance selection handling and refactor utility functions
-- rebuild as self-aligned enterprise grid
-- add footer slot support and update styles
-
-### 修复
-
-- adjust sort icon styles for better alignment
-
-### 文档
-
-- update decision recipes and enhance documentation for new features
-- sync changelog and Table guidance across packages
-- document enterprise capabilities and demos
-
-### 变更
-
-- update shadow styles for improved visual consistency
-
-## 0.3.6
-
-### 新功能
-
-- MTable：列宽拖拽、表头筛选、行虚拟滚动、列显隐/顺序、多级表头、表尾汇总、单元格合并
-- MTable 树模式与树 API、`checkboxConfig` / `radioConfig`、详情 `expandConfig`
-- MTable 实例方法：选择 / 滚动 / `clearSort` / `clearFilter` / 详情展开
-- MTable 分层重构（core / state / columns / render）与合成列内部命名空间
-
-### 破坏性变更
-
-- 移除内置单元格编辑：`editConfig`、列 `editable`、`edit-change`、`#edit-{key}`；请用 `#cell-{key}` / `render` 自定义
-- 移除 `MTreeTable`（含 `morya-ui/tree-table`）；树表改用 `MTable` + `treeConfig`
-- `serverItemsLength` → `serverTotal`；`rowsItems` → `pageSizes`
-- 移除 `hideHeader` / `hideRowsPerPage`，改用 `showHeader` / `showRowsPerPage`（均默认 `true`）
-- 移除 `clickEventType`、`tableNodeId`、分页文案 props、`preventContextMenuRow`
-- 事件重命名为 kebab-case：`row-contextmenu`、`select-row`、`deselect-row`、`select-all`；新增 `row-dblclick`
-- 移除 `updatePageItems`、`updateTotalItems`、`page`（保留 `update:page`）；移除 `TableClickEventType` 导出
-
-### 修复
-
-- MTable 服务端/客户端 multiSort、受控 page/rowsPerPage/sort、表头全选当前页、aria-label 挂 table、展开按钮文案与排序 focus-ring
-
-### 文档
-
-- add portable AGENTS.md and multi-editor MCP docs
-- MTable 文档与 ui-mcp catalog 同步
-## 0.3.5
+# morya-ui
+
+## 0.4.4
 
 ### 新功能
 
-- upgrade morya-ui and @morya-ui packages to latest on run
-- add trailing actions slot and advanced toggle chrome
-
-## 0.3.4
-
-### 新功能
-
-- add conditional fill height for admin list pages
-- enhance size prop to accept CSS length strings and update documentation
-
-## 0.3.3
-
-### 新功能
-
-- add L2 decision recipes for component selection
-- support disabling the link underline
-
-### 修复
-
-- dismiss overlay on page scroll or resize
-- align overlay motion with scale-fade
-- correct link, plain, and ghost variant styles
-- disable ripple and press by default
-- correct import paths for styles in Card, Icon, Page, and Pagination components
+- add script to generate Juejin cover image and update HomeView layout
 
 ### 文档
 
-- wire morya-ui-pages to decision recipes
-
-### 变更
-
-- align menu item chrome with Select and Dropdown
-- add full Button prop demos
-
-## 0.3.2
-
-### 新功能
-
-- add click ripple and a press-scale toggle
-- add link underline toggle
-- replace quick jumper with a filterable Select
-- refine ops layout primitives and P2 filter/stat APIs
-- add shadow prop and remove hoverable
-
-### 修复
-
-- keep link buttons backgroundless on hover and press
-- make plain match outlined hover fill
-- make ghost match text hover fill
-- Panel component change demo component width
-- remove OS reduced-motion media queries from components
-- control intensity via library preference only
-
-### 文档
-
-- document impeccable and skills-cli companion install
-- document library-only motion control
-
-### 变更
-
-- disable button click ripple by default
-- disable button press scale by default
-- extract filter and expanded-key helpers
-- extract label filter helpers for option lists
-- extract sort, filter, and selection helpers
-- extract expand and visible-entry helpers
-- extract option filter and multi-select helpers
-- cover CommandMenu keys and FileUpload dropzone keyboard
-- extract accept and size helpers
-- polish overlay scale, press feedback, and scroll containment
-- refresh snippets, generators, and golden page copies
-
-## 0.3.1
-
-### 新功能
-
-- replace hand-drawn icons with a generated Tabler registry
-- add option groups and header/footer slots
-- add triangle icons and update icon rendering logic
-- animate pages with a sliding track
-
-### 修复
-
-- keep the range start thumb above the overlapping track
-- keep submenus open on hover and align items with Select
-- make the expanded-row loading line visible
-- let popup menus grow with their content
-- let the menu grow with its content
-- close the gap in the sider bar trigger
-- compact dropdown filter and keep menu width aligned
-- shrink oversized multi-select tags
-
-### 文档
-
-- describe the all-Tabler registry and the generator script
-- complete component API tables and instance methods
-
-### 变更
-
-- fix export order and prefer template literals in gallery demos
-- resolve newly registered icons directly and drop dead aliases
-- replace the custom loading overlay with MLoading
-- update header and sort styles for improved layout
-
-## 0.3.0
-
-### 新功能
-
-- align Select-like overlays and selection UX
-- enhance styling and line numbering for code previews
-- virtualize Select, Listbox, and AutoComplete menus
-- customize gutter via slot, class, and style
-- pause looping animations when off-screen
-- add collapse height transition
-- add global reduced-motion transition fallbacks
-- wire transition presets into overlay components
-- add global motion config and public exports
-- add named enter/exit preset registry
-- require validate_usage before page delivery
-
-### 修复
-
-- scale control affix and layout tokens with density
-- default Dialog and ConfirmDialog transition to zoom
-- animate Dialog and Drawer panels for shared presets
-- keep default presets when transition prop is omitted
-- harden reduced-motion tokens and ignore gates
-- make style entries and MCP catalog generation idempotent
-
-### 文档
-
-- sync Splitter gutter API in MCP and skills
-- add optional Animate.css integration example
-- add dedicated motion guide and docs section nav
-- document transition presets and playground demo
-- document new golden pages and validate_page contracts
-
-### 变更
-
-- sync on-demand style entries and design token catalog
-- replace hardcoded sizes with density-aware design tokens
-- extract useFloatingViewportSync for overlays
-- cut redundant observers and layout work
-- drive ProgressBar fill with scaleX
-- replace loading aurora blur with soft gradients
-- avoid width layout animation on sider chrome
-- avoid layout thrash in collapse and float label
-
-## 0.2.9
-
-### 新功能
-
-- require a craft pass and add Ops polish recipes
-- add categorized Tabler built-in icons
-- add Loading component
-
-### 修复
-
-- align Table rows and MMessage host guidance with the real API
-- adjust width of selection demo for better layout
-- align trailing icon insets with input affixes
-- size input affixes from content instead of fixed padding
-- add block padding so vertical menus are not flush to edges
-
-### 文档
-
-- sync MCP and setup docs with the current AI tooling
-- document optional setup skills and companions
-- add Loading docs and demos
-
-### 变更
-
-- simplify sider and content into single-element shells
-- refresh Loading circular design tokens
-
-## 0.2.8
-
-### 新功能
-
-- 新增 Loading 加载组件
-
-### 文档
-
-- 补充 Loading 中英文文档与示例
-- update quick start guide for kebab-case imports and dts configuration
-
-### 变更
-
-- stop copying docs into consumer apps
-- stop copying design tokens and page examples
-
-## 0.2.7
-
-### 新功能
-
-- add variant and unify status presentation styles
-- redesign Result API and HTTP illustrations
-- add illustration catalog and enhance empty states
-
-### 修复
-
-- Menu RouterLink, Dialog panel width, and Tree indeterminate state
-
-### 文档
-
-- add one-shot setup guide page
-- remove other-library comparison wording from docs and comments
-
-### 变更
-
-- rename ai-design-config to design-kit
-- sync design tokens for Empty, Result, and Status
-
-## 0.2.6
-
-### 新功能
-
-- enhance SEO and documentation for Morya UI
-
-### 修复
-
-- harden Layout fillViewport, Menu links, and ConfigProvider theme
-
-### 文档
-
-- update component count to 90+ in README and related files
-
-## 0.2.5
-
-### 破坏性变更
-
-- rebrand WiseKit to morya-ui with M-prefixed public API
-- drop deprecated prop and CSS aliases
-
-### 新功能
-
-- export Empty, Result, and Status from the library
-- add empty state component
-- add result page component with locale strings
-- add status indicator component
-- extract guide page previews into demo SFCs
-- extract component previews into shared demo SFCs
-- support UnoCSS demos and markdown preview src=
-- add new route for components demos page
-- theme Tabs, Gallery, Timeline, and Textarea scrolling
-- use MScrollbar in data and panel scroll surfaces
-- theme popup and flyout scroll with MScrollbar
-- use MScrollbar in dialogs, drawers, and popovers
-- route layout scroll through MScrollbar
-- add ScrollBody and FlyoutSubmenu for themed scrolling
-- add page composition tooling for AI agents
-- add MPage composition components for admin layouts
-- add tooltip support for collapsed menu items
-- link API table types to doc anchors
-- add hybrid fallthrough attrs helpers
-- enhance design token management and documentation
-- add reduced motion policy support across components
-- integrate WkScrollbar into AutoComplete, CascadeSelect, CommandMenu, and Listbox components
-- enhance WkSelect component with scrollbar and max-height functionality
-- rebrand to @wex-design/ui and reset release baseline to 0.0.1
-- add SSR support for Nuxt, Astro, and Vite
-- enhance admin management project with new components and feedback system
-- enhance ConfirmDialog and Accordion components
-- add design-system guardrails and shared primitives
-- add admin management project with initial setup and configuration
-- enhance Table component with scrollbar and styling improvements
-- implement dynamic icon sizing across components
-- enhance resource management and documentation in MCP
-- add mobile sidebar drawer for docs and components
-- add global site search with CommandMenu
-- persist language in URL query
-- add dedicated 404 page
-- add favicon and meta description
-- Harden MCP catalog tooling
-- enhance package exports and sideEffects for improved component management
-- add extra slot and enhance components in Accordion and AutoComplete
-- enhance component defaults and improve configuration management
-- add component registry import to index for improved component management
-- enhance documentation and component registration for WellInsight
-- enhance release process to include MCP build and version sync
-- Add MCP server documentation and package reference
-- bootstrap standalone @well-insight/ui component library
-
-### 修复
-
-- disable respect reduced motion for improved layout consistency
-- tighten layout typing and demo typecheck
-- improve dark semantic contrast and layout rem tokens
-- import Scrollbar styles in on-demand component entries
-- restore sider content opacity after MScrollbar
-- leave Dialog and Drawer scroll to app code
-- stop forcing MScrollbar on user-customizable regions
-- register Page styles in global stylesheet
-- support uncontrolled open and slot trigger
-- rename Nuxt module to morya-ui-nuxt for npm publish
-- restore wd compat import paths after bulk rename
-- fix api with component
-- unify suffix icons and Select clearable hover behavior
-- restore DatePicker panel grid after teleport
-- add invalid modifier class alongside error alias
-- improve FloatLabel, Popover, and Slider
-- scroll doc TOC inside WiScrollbar
-- repair guide links and quick-start copy
-- Fix layout header and footer padding axis
-- Expose component-specific CSS variables and adjust layout defaults
-- Add Configurable Layout Sizing And CSS Tokens
-- Improve playground navigation styling
-- Standardize Project Linting And Module Exports
-- rename Wd to Wi in component library and documentation
-
-### 文档
-
-- note style polish and enable docs reduced-motion
-- add AI setup and Agent Skill guides
-- recommend npx @morya-ui/setup for one-shot onboarding
-- move contributor guide out of the public docs site
-- add type sections at end of component docs
-- document shared types and type link conventions
-- document pt props and trim attrs boilerplate
-- add attrs and types guides with updated nav
-- describe Vue 3 support with 3.5+ recommendation
-- polish docs site home, changelog, and branding
-- rebrand as open-source library with logo and README
-- complete Events/Slots sections and remove migration guide
-- add Events and a11y sections to high-traffic components
-- rename Basic sections to 基础用法 in Chinese component docs
-- add accessibility guide for playground
-- expand menu and virtual scroller component pages
-- add deprecated API migration guide
-- Add UI MCP server and docs site links
-- Update install docs to omit explicit Vue dependency
-
-### 变更
-
-- polish component styles and shared base motion
-- refresh docs site visual polish
-- remove redundant package declaration and update peer dependency rules
-- regenerate design tokens for scrollbar-related CSS vars
-- import additional styles for Card and Icon components
-- improve submenu arrow icon and expand behavior
-- update dataset keys from 'mu' to 'm' for consistency
-- add component doc type section tooling
-- add attrs audit and doc maintenance tooling
-- apply hybrid attrs routing across library
-- update documentation links to reflect new GitHub Pages URL
-- rename satellite packages to @morya-ui scope
-- migrate to Wk tokens and remove legacy compat layers
-- rebrand to @wise-kit/ui and reset release baseline to 0.1.1
-- update @roost-design/ui version in pnpm-lock.yaml and enhance SiteHeader component
-- rebrand library to @roost-design/ui and reset version to 0.1.1
-- update catalog generation timestamp and adjust component exports
-- rebrand library from @wex-design/ui to @roost-design/ui
-- reset release baseline to 0.1.1 with fresh changelog
-- update Vue peer dependency and documentation references
-- deploy docs site to GitHub Pages
-- remove admin-manage-project from monorepo
-- update check-docs-drift script and package.json
-- update CHANGELOG for version 0.1.14
-- update Table component to use columns and rows structure
-- update Table component structure and improve functionality
-- import Icon styles across multiple components
-- enhance MobileSidebarShell and DocsView layout with improved flex properties
-- unify clearable API across pickers (phase 6b)
-- phase 6a icon unification and shared picker suffix
-- split vendor chunks and replace eager markdown manifest
-- add unit tests for 16 sub-components
-- migrate remaining overlays to shared placement util
-- add shared menu icon and key utilities
-- replace hardcoded colors with design tokens
-- migrate Select and Dropdown to shared overlay placement
-- extract shared overlay placement utility
-- lazy-load routes and markdown docs
-- streamline MCP tools from 18 to 13
-- Simplify layout components by removing custom scrollbar support and enhancing layout styles
-- clean up whitespace in base.css for consistency
-- Simplify package.json exports by removing development paths for styles and index files
-- restructure release process and update documentation
-
-## Unreleased
-
-### 修复
-
-- Dropdown / SplitButton 传送菜单层级改为 `--m-z-dropdown`（与 Select / Menu 一致）
-- ProgressSpinner wrap 遮罩补局部 z-index，避免被内容盖住
-- 暗色主题语义实心色（success / danger 等）加深，保证与 `--m-color-on-emphasis` 对比可读
-- Button / Badge / 共享进出场 / Dialog / Drawer / Popover / Message / BlockUI 补齐 reduced-motion
-- Layout 默认宽高改为 rem token；ScrollRegion 样式类型与 Scrollbar 对齐
-- 文档站开启 `respect-reduced-motion`；修复 guide manifest 单测
-
-### 变更
-
-- 全库组件样式 polish（Batch 0–6）：状态、token、反馈层级与布局细节
-- Message / Toast `findDuplicate*` 补充显式返回类型
-
-## 0.2.4
-
-### 新功能
-
-- add new route for components demos page
-- theme Tabs, Gallery, Timeline, and Textarea scrolling
-- use MScrollbar in data and panel scroll surfaces
-- theme popup and flyout scroll with MScrollbar
-- use MScrollbar in dialogs, drawers, and popovers
-- route layout scroll through MScrollbar
-- add ScrollBody and FlyoutSubmenu for themed scrolling
-
-### 修复
-
-- leave Dialog and Drawer scroll to app code
-- stop forcing MScrollbar on user-customizable regions
-
-### 变更
-
-- regenerate design tokens for scrollbar-related CSS vars
-- import additional styles for Card and Icon components
-
-## 0.2.3
-
-### 新功能
-
-- add page composition tooling for AI agents
-- add MPage composition components for admin layouts
-
-### 修复
-
-- register Page styles in global stylesheet
-
-## 0.2.2
-
-### 新功能
-
-- add tooltip support for collapsed menu items
-
-### 变更
-
-- improve submenu arrow icon and expand behavior
-- update dataset keys from 'mu' to 'm' for consistency
-
-## 0.2.1
-
-### 破坏性变更
-
-- rebrand WiseKit to morya-ui with M-prefixed public API
-
-### 新功能
-
-- link API table types to doc anchors
-- add hybrid fallthrough attrs helpers
-
-### 修复
-
-- support uncontrolled open and slot trigger
-- rename Nuxt module to morya-ui-nuxt for npm publish
-
-### 文档
-
-- add type sections at end of component docs
-- document shared types and type link conventions
-- document pt props and trim attrs boilerplate
-- add attrs and types guides with updated nav
-
-### 变更
-
-- add component doc type section tooling
-- add attrs audit and doc maintenance tooling
-- apply hybrid attrs routing across library
-- update documentation links to reflect new GitHub Pages URL
-- rename satellite packages to @morya-ui scope
-
-## 0.1.1
-
-`morya-ui` 的初始公开版本（Morya UI），以当前组件库能力为基准。
-
-### 组件（88 个）
-
-- **基础**：Button、ButtonGroup、Icon、Avatar、AvatarGroup、Badge、Chip、Tag、Divider、Skeleton、ProgressBar、ProgressSpinner、BlockUI、ScrollTop
-- **表单**：Input、Textarea、InputNumber、InputPassword、InputOtp、InputTags、InputColor、InputGroup、InputGroupAddon、IconField、FloatLabel、Label、Checkbox、CheckboxGroup、Radio、RadioGroup、Switch、Select、SelectButton、ToggleButton、Slider、Knob、Rating、DatePicker、AutoComplete、CascadeSelect、TreeSelect、FileUpload、Form、FormItem
-- **浮层与对话框**：Dialog、Drawer、Popover、Tooltip、ConfirmDialog、ConfirmPopup、ContextMenu、Dropdown、SplitButton、SpeedDial
-- **数据展示**：Table、Tree、TreeTable、TreeSelect、DataView、VirtualScroller、Timeline、MeterGroup、Terminal、Gallery、Carousel、Inplace
-- **导航与菜单**：Menu、Menubar、MegaMenu、TieredMenu、Breadcrumb、Tabs、Stepper、Pagination、CommandMenu、Dock、Sidebar
-- **布局**：Layout（Header / Sider / Content / Footer）、Grid、Flex、Space、Fluid、Panel、Card、Fieldset、Accordion、Splitter、Toolbar、Listbox、PickList、OrderList、Scrollbar
-
-### 主题与设计令牌
-
-- 亮/暗色主题（`useTheme`、`applyTheme`、`getPreferredTheme`）
-- 密度与动效偏好（`useDensity`、`useMotion`，支持 `prefers-reduced-motion` 与 `data-m-motion`）
-- 基于 `--m-*` CSS 变量的设计令牌体系（颜色、间距、圆角、阴影、边框、布局、树形、时间线、分割面板等）
-- 子树级覆盖：`MConfigProvider` 注入主题、密度、动效与组件默认项
-
-### 全局配置与工具 API
-
-- 插件入口：`MoryaUI` 全量注册、`createMoryaUI` 按需/默认配置
-- 按需构建：`MoryaUIResolver`（配合 `unplugin-vue-components`）
-- ESM 子路径导出（`morya-ui/button` 等），tree-shaking 友好
-- 命令式 API：`useConfirm`、`useToast` / `toast`、`useMessage` / `message`、`useContextMenu`
-- 共享 composable：`useControllable`、`useFieldFeedback`、`useMenuKeyboard`、`useModalOverlay`、`useMId`
-- 国际化：`zhCN`、`enUS`、`mergeLocale`、`useMLocale`、`formatLocale`
-
-### 打包与类型
-
-- 产物：ESM + 类型声明 + 聚合样式 `styles.css`
-- 完整 TypeScript 类型（Props、Emits、Slots、Locale）
-- `sideEffects` 与细粒度 exports，支持按组件引入样式
-
-### 文档站
-
-- 交互式文档站（Markdown + `vue preview` 实时示例）
-- 组件目录、指南（快速上手、主题、配置、SSR、无障碍、MCP）
-- 亮/暗主题切换、中英文切换、全局搜索（CommandMenu）
-- 部署至 GitHub Pages：https://morya-space.github.io/morya-ui/
-
-### 生态包
-
-- **`@morya-ui/nuxt`**：Nuxt 3 模块（样式注入、transpile、客户端 overlay 上下文）
-- **`@morya-ui/mcp`**：MCP 服务，供 AI 客户端检索组件文档、示例与用法建议
-
-### SSR 与框架集成
-
-- 兼容 Nuxt 3、Astro + Vue、Vite SSR 等场景（推荐 Vue 3.5+）
-- 浮层统一挂载与 placement（flip / clamp）策略
-
-### 无障碍
-
-- 表单控件、Tabs、Slider、Switch、MeterGroup、ProgressSpinner 等核心路径的 ARIA 与键盘支持
-- 菜单类组件统一键盘导航（`useMenuKeyboard`）
-- Tree / TreeTable treegrid 语义
-
-### 质量
-
-- 600+ 单元测试用例
-- `check:tokens` / `check:colors` 设计令牌校验
+- document --create scaffolding and interactive mode
+- update AGENTS.md usage rules and add new blog article on Morya UI
+
+## 0.4.3
+
+### 修复
+
+- Button pt 类型与 PageFilters 文案插空
+
+### 变更
+
+- 语义色 severity 统一为 type
+- add ConfigProvider styles import
+
+## 0.4.2
+
+### 新功能
+
+- add MTable component and support column align props and scroll height settings
+
+### 修复
+
+- align loading, defaults, and outlined active styles
+- MMessage component icon align center
+
+### 文档
+
+- clarify ButtonGroup as visual-only grouping
+- tighten public docs and reorder demos
+- sync demos and MCP after dual-axis API
+
+### 变更
+
+- remove built-in badge API
+- tokenize styles against theme tokens
+- update button props and remove severity prop
+
+## Unreleased
+
+### 破坏性变更
+
+- **Button**：改为 `type` / `color` × `variant` 双轴 API
+  - 新增 `type` 语法糖（`default` / `primary` / `dashed` / `link` / `text`）与 `color` × `variant`
+  - 删除 `severity`；危险色改用 `danger` / `color="danger"`
+  - `fluid` → `block`；`nativeType` → `htmlType`；`iconPos` → `iconPlacement`
+  - 删除内置 `badge` / `badgeColor`；角标请用 `MBadge` 包裹按钮
+  - 支持 `href` / `ghost` / `loading` 对象形态与 `pt`
+- **语义色 prop**：Badge / Tag / Chip / Status / Alert / Message / Toast 等将 `severity` 统一为 `type`
+  - `warn` → `warning`；Alert / Message / Toast 失败态 `error` → `danger`
+  - 共享类型改为 `MToneType` / `MTagType` / `MToastType`（不再导出 `MSeverity`）
+
+### 修复
+
+- **Button**：loading 时不再误加原生 `disabled`（避免灰掉主色）
+- **Button**：`shape` / `ripple` / `press` 正确继承 `componentDefaults`，本地可覆盖
+- **Button**：`:active` 同步边框与文字色；默认 outlined / dashed 按下保持表面色背景
+
+### 文档
+
+- 补齐 Button 文档 demo：ColorVariant / Icon / Size / Ghost / Danger / Block / RipplePress
+- 同步 MCP catalog、setup / design-kit 约定，以及 `morya-ui-pages` skill 中的 Button API
+
+## 0.4.1
+
+### 破坏性变更
+
+- rewrite public component API
+
+### 新功能
+
+- ability to add transparent root node attributes to multiple components
+
+### 修复
+
+- components name change
+- ensure single root vnode for Transition classes and update design tokens
+
+### 文档
+
+- add components pt attr
+- refresh demos for effects, multi-view, and vertical
+
+### 变更
+
+- update component library
+- unify focus and hover states across components
+- sync MCP catalog and design tokens for Carousel
+- standardize import statements across components and update styles
+
+## 0.4.0
+
+### 新功能
+
+- wire filled variant and allow null model values
+- add eight additional locale packs
+- add thin DatePicker time wrapper
+- add a notification API and richer messages
+- add an imperative modal API
+- add a 24-column flex grid with responsive Row/Col
+- add a controlled form instance, nested fields and FormList
+- add copyable, editable and multi-line ellipsis
+- add copy, edit and field validation messages
+- support theme overrides, global disabled and RTL
+- add a seed-driven token derivation engine
+- add MList with meta rows and pagination
+- add MCalendar with fullscreen and range guards
+- add Segmented, Mentions, and Statistic
+- add Affix, Anchor, Tour, Watermark, and QRCode
+- deepen Dialog, Progress, Loading, and docs tone
+- polish Tag density and Table filter summary
+- deepen Form, inputs, and Select status handling
+- deepen Breadcrumb, Dropdown, Pagination, Stepper, Tabs
+- deepen Divider, Flex, Splitter, Space, and Layout
+- expand type coverage for time and ranges
+- add dashed variant, shapes, and float polish
+- add MTitle, MText, MParagraph, and MLink
+- add MImage with click-to-preview group
+- add MDescriptions and MDescriptionsItem
+- add MAlert for persistent in-page notices
+- refresh default tokens for enterprise visual feel
+
+### 修复
+
+- allow FormList initialValue factories and document FormList
+- add missing tokens and tokenize Button active color
+- unblock typecheck and map morya-ui to source
+- tile the overlay at the real pattern size
+- repair an invalid byte in the base stylesheet comment
+
+### 文档
+
+- repair List docs and restore corrupted Chinese API pages
+- clear remaining component API docs drift
+- cut List/Page/Grid docs drift and harden the auditor
+- add TimePicker events table and improve drift audits
+- drop when-to-use sections that restate the description
+- restructure navigation and add recipe walkthroughs
+- remove boilerplate tip from when-to-use sections
+- drop third-party parity references from docs and code
+- add design specs, mapping and theme editor
+- backfill when-to-use sections
+- add nested options demo
+- add conventions page for naming and feedback vocabulary
+
+### 变更
+
+- normalize double-spaced sources and CSS file headers
+- cut false positives in the API auditor
+- add typecheck and unit-test gates; fix Vitest includes
+- add size, docs-smoke and visual quality gates
+- export and register the new components
+- export and register new enterprise components
+
+## 0.3.8
+
+### 新功能
+
+- enhance agent skill management and documentation
+- 新增 `MAlert`：页面内嵌常驻提示（severity / closable / banner / action）
+- `MDatePicker` 扩展 `type`：`datetime` / `datetimerange` / `time` / `month` / `year`，并支持 `showSeconds`
+- 新增 `MList` / `MListItem` / `MListItemMeta`（`items` + Meta + 分页 / grid）
+- 新增 `MDescriptions` / `MDescriptionsItem`
+- 新增 `MImage` / `MImagePreviewGroup`（点击预览）
+- 新增 `MTypography`（`MTitle` / `MText` / `MParagraph` / `MLink`）
+- 按钮补齐 `variant="dashed"` / `shape`、描边默认态、字重 400、disabled 灰底；通栏用 `fluid`
+- 布局：`Divider` plain/size/orientation、`Flex` `gap` 别名、`Splitter` min2、sider 折叠宽 token 默认 80px
+- 导航：Breadcrumb `href`、Pagination `size`/`showSizeChanger`、Stepper `status`/`size`、Tabs `size`/`centered`、Dropdown `disabled`
+- 数据展示：`MTag` 密度与 `checkable`；`MTable` `size` 单元格 padding
+- 反馈：Dialog `maskClosable`/`centered`、ProgressBar `exception`/`active`、Loading/ProgressSpinner `tip`
+- 表单：Form `requiredMark` 别名 / `scrollToField` / `scrollToFirstError` / `size` 继承；输入类 `allowClear` 与 `status`；Select `status`；`--m-focus-shadow-warning`
+- 新增 `MAffix` / `MWatermark` / `MQRCode`（固钉 / 水印 / 二维码与状态遮罩）
+- 新增 `MAnchor` / `MAnchorLink`、`MTour`（`v-model:open` / `v-model:current`）
+- 新增 `MStatistic` / `MStatisticCountdown`
+- 新增 `MSegmented`（`options` / `block` / `shape` / `size`，`radiogroup` 键盘）
+- 新增 `MMentions`（`prefix` / `split` / 建议插入 / `@select`）
+- 新增 `MCalendar`（`fullscreen` / `showWeek` / `validRange` / `#dateCell` / `#header`）
+- `MTour` 键盘漫游 + `gap`；`MMentions` `allowClear` / `loading`；`MWatermark` overlay 防误删重绘；`MQRCode` `#statusRender`
+- `MTable` 表头筛选清除/确认分离、页脚合计与虚拟滚动约束提示
+
+### 变更
+
+- 默认主题：主色 `#1677FF`、中性字色/描边、控件高度 medium `32px`、控件圆角 `6px`、卡片圆角 `8px`、多层投影与更实的聚焦环
+- 字体栈改为系统无衬线；控件标签/表头/页签字重 500（页面标题仍 600）；动效 ease-out + 位移 `0.5rem`
+- 禁用态优先 `--m-color-text-disabled` / `--m-color-bg-disabled`，输入与页签等不再只靠 opacity
+- Pagination 默认尺寸由固定 small 改为 `size="medium"`（可用 `size` 调整）
+- `MTag` 默认字重 400、水平内边距约 8px，描边改为真实 `border`（保留透明边框占位）
+
+### 文档
+
+- 指南新增「约定」：命名、`severity` / `variant`、反馈与布局词表
+
+## 0.3.7
+
+### 新功能
+
+- add tree mode, instance APIs, and drop cell editing
+- enhance selection handling and refactor utility functions
+- rebuild as self-aligned enterprise grid
+- add footer slot support and update styles
+
+### 修复
+
+- adjust sort icon styles for better alignment
+
+### 文档
+
+- update decision recipes and enhance documentation for new features
+- sync changelog and Table guidance across packages
+- document enterprise capabilities and demos
+
+### 变更
+
+- update shadow styles for improved visual consistency
+
+## 0.3.6
+
+### 新功能
+
+- MTable：列宽拖拽、表头筛选、行虚拟滚动、列显隐/顺序、多级表头、表尾汇总、单元格合并
+- MTable 树模式与树 API、`checkboxConfig` / `radioConfig`、详情 `expandConfig`
+- MTable 实例方法：选择 / 滚动 / `clearSort` / `clearFilter` / 详情展开
+- MTable 分层重构（core / state / columns / render）与合成列内部命名空间
+
+### 破坏性变更
+
+- 移除内置单元格编辑：`editConfig`、列 `editable`、`edit-change`、`#edit-{key}`；请用 `#cell-{key}` / `render` 自定义
+- 移除 `MTreeTable`（含 `morya-ui/tree-table`）；树表改用 `MTable` + `treeConfig`
+- `serverItemsLength` → `serverTotal`；`rowsItems` → `pageSizes`
+- 移除 `hideHeader` / `hideRowsPerPage`，改用 `showHeader` / `showRowsPerPage`（均默认 `true`）
+- 移除 `clickEventType`、`tableNodeId`、分页文案 props、`preventContextMenuRow`
+- 事件重命名为 kebab-case：`row-contextmenu`、`select-row`、`deselect-row`、`select-all`；新增 `row-dblclick`
+- 移除 `updatePageItems`、`updateTotalItems`、`page`（保留 `update:page`）；移除 `TableClickEventType` 导出
+
+### 修复
+
+- MTable 服务端/客户端 multiSort、受控 page/rowsPerPage/sort、表头全选当前页、aria-label 挂 table、展开按钮文案与排序 focus-ring
+
+### 文档
+
+- add portable AGENTS.md and multi-editor MCP docs
+- MTable 文档与 ui-mcp catalog 同步
+## 0.3.5
+
+### 新功能
+
+- upgrade morya-ui and @morya-ui packages to latest on run
+- add trailing actions slot and advanced toggle chrome
+
+## 0.3.4
+
+### 新功能
+
+- add conditional fill height for admin list pages
+- enhance size prop to accept CSS length strings and update documentation
+
+## 0.3.3
+
+### 新功能
+
+- add L2 decision recipes for component selection
+- support disabling the link underline
+
+### 修复
+
+- dismiss overlay on page scroll or resize
+- align overlay motion with scale-fade
+- correct link, plain, and ghost variant styles
+- disable ripple and press by default
+- correct import paths for styles in Card, Icon, Page, and Pagination components
+
+### 文档
+
+- wire morya-ui-pages to decision recipes
+
+### 变更
+
+- align menu item chrome with Select and Dropdown
+- add full Button prop demos
+
+## 0.3.2
+
+### 新功能
+
+- add click ripple and a press-scale toggle
+- add link underline toggle
+- replace quick jumper with a filterable Select
+- refine ops layout primitives and P2 filter/stat APIs
+- add shadow prop and remove hoverable
+
+### 修复
+
+- keep link buttons backgroundless on hover and press
+- make plain match outlined hover fill
+- make ghost match text hover fill
+- Panel component change demo component width
+- remove OS reduced-motion media queries from components
+- control intensity via library preference only
+
+### 文档
+
+- document impeccable and skills-cli companion install
+- document library-only motion control
+
+### 变更
+
+- disable button click ripple by default
+- disable button press scale by default
+- extract filter and expanded-key helpers
+- extract label filter helpers for option lists
+- extract sort, filter, and selection helpers
+- extract expand and visible-entry helpers
+- extract option filter and multi-select helpers
+- cover CommandMenu keys and FileUpload dropzone keyboard
+- extract accept and size helpers
+- polish overlay scale, press feedback, and scroll containment
+- refresh snippets, generators, and golden page copies
+
+## 0.3.1
+
+### 新功能
+
+- replace hand-drawn icons with a generated Tabler registry
+- add option groups and header/footer slots
+- add triangle icons and update icon rendering logic
+- animate pages with a sliding track
+
+### 修复
+
+- keep the range start thumb above the overlapping track
+- keep submenus open on hover and align items with Select
+- make the expanded-row loading line visible
+- let popup menus grow with their content
+- let the menu grow with its content
+- close the gap in the sider bar trigger
+- compact dropdown filter and keep menu width aligned
+- shrink oversized multi-select tags
+
+### 文档
+
+- describe the all-Tabler registry and the generator script
+- complete component API tables and instance methods
+
+### 变更
+
+- fix export order and prefer template literals in gallery demos
+- resolve newly registered icons directly and drop dead aliases
+- replace the custom loading overlay with MLoading
+- update header and sort styles for improved layout
+
+## 0.3.0
+
+### 新功能
+
+- align Select-like overlays and selection UX
+- enhance styling and line numbering for code previews
+- virtualize Select, Listbox, and AutoComplete menus
+- customize gutter via slot, class, and style
+- pause looping animations when off-screen
+- add collapse height transition
+- add global reduced-motion transition fallbacks
+- wire transition presets into overlay components
+- add global motion config and public exports
+- add named enter/exit preset registry
+- require validate_usage before page delivery
+
+### 修复
+
+- scale control affix and layout tokens with density
+- default Dialog and ConfirmDialog transition to zoom
+- animate Dialog and Drawer panels for shared presets
+- keep default presets when transition prop is omitted
+- harden reduced-motion tokens and ignore gates
+- make style entries and MCP catalog generation idempotent
+
+### 文档
+
+- sync Splitter gutter API in MCP and skills
+- add optional Animate.css integration example
+- add dedicated motion guide and docs section nav
+- document transition presets and playground demo
+- document new golden pages and validate_page contracts
+
+### 变更
+
+- sync on-demand style entries and design token catalog
+- replace hardcoded sizes with density-aware design tokens
+- extract useFloatingViewportSync for overlays
+- cut redundant observers and layout work
+- drive ProgressBar fill with scaleX
+- replace loading aurora blur with soft gradients
+- avoid width layout animation on sider chrome
+- avoid layout thrash in collapse and float label
+
+## 0.2.9
+
+### 新功能
+
+- require a craft pass and add Ops polish recipes
+- add categorized Tabler built-in icons
+- add Loading component
+
+### 修复
+
+- align Table rows and MMessage host guidance with the real API
+- adjust width of selection demo for better layout
+- align trailing icon insets with input affixes
+- size input affixes from content instead of fixed padding
+- add block padding so vertical menus are not flush to edges
+
+### 文档
+
+- sync MCP and setup docs with the current AI tooling
+- document optional setup skills and companions
+- add Loading docs and demos
+
+### 变更
+
+- simplify sider and content into single-element shells
+- refresh Loading circular design tokens
+
+## 0.2.8
+
+### 新功能
+
+- 新增 Loading 加载组件
+
+### 文档
+
+- 补充 Loading 中英文文档与示例
+- update quick start guide for kebab-case imports and dts configuration
+
+### 变更
+
+- stop copying docs into consumer apps
+- stop copying design tokens and page examples
+
+## 0.2.7
+
+### 新功能
+
+- add variant and unify status presentation styles
+- redesign Result API and HTTP illustrations
+- add illustration catalog and enhance empty states
+
+### 修复
+
+- Menu RouterLink, Dialog panel width, and Tree indeterminate state
+
+### 文档
+
+- add one-shot setup guide page
+- remove other-library comparison wording from docs and comments
+
+### 变更
+
+- rename ai-design-config to design-kit
+- sync design tokens for Empty, Result, and Status
+
+## 0.2.6
+
+### 新功能
+
+- enhance SEO and documentation for Morya UI
+
+### 修复
+
+- harden Layout fillViewport, Menu links, and ConfigProvider theme
+
+### 文档
+
+- update component count to 90+ in README and related files
+
+## 0.2.5
+
+### 破坏性变更
+
+- rebrand WiseKit to morya-ui with M-prefixed public API
+- drop deprecated prop and CSS aliases
+
+### 新功能
+
+- export Empty, Result, and Status from the library
+- add empty state component
+- add result page component with locale strings
+- add status indicator component
+- extract guide page previews into demo SFCs
+- extract component previews into shared demo SFCs
+- support UnoCSS demos and markdown preview src=
+- add new route for components demos page
+- theme Tabs, Gallery, Timeline, and Textarea scrolling
+- use MScrollbar in data and panel scroll surfaces
+- theme popup and flyout scroll with MScrollbar
+- use MScrollbar in dialogs, drawers, and popovers
+- route layout scroll through MScrollbar
+- add ScrollBody and FlyoutSubmenu for themed scrolling
+- add page composition tooling for AI agents
+- add MPage composition components for admin layouts
+- add tooltip support for collapsed menu items
+- link API table types to doc anchors
+- add hybrid fallthrough attrs helpers
+- enhance design token management and documentation
+- add reduced motion policy support across components
+- integrate WkScrollbar into AutoComplete, CascadeSelect, CommandMenu, and Listbox components
+- enhance WkSelect component with scrollbar and max-height functionality
+- rebrand to @wex-design/ui and reset release baseline to 0.0.1
+- add SSR support for Nuxt, Astro, and Vite
+- enhance admin management project with new components and feedback system
+- enhance ConfirmDialog and Accordion components
+- add design-system guardrails and shared primitives
+- add admin management project with initial setup and configuration
+- enhance Table component with scrollbar and styling improvements
+- implement dynamic icon sizing across components
+- enhance resource management and documentation in MCP
+- add mobile sidebar drawer for docs and components
+- add global site search with CommandMenu
+- persist language in URL query
+- add dedicated 404 page
+- add favicon and meta description
+- Harden MCP catalog tooling
+- enhance package exports and sideEffects for improved component management
+- add extra slot and enhance components in Accordion and AutoComplete
+- enhance component defaults and improve configuration management
+- add component registry import to index for improved component management
+- enhance documentation and component registration for WellInsight
+- enhance release process to include MCP build and version sync
+- Add MCP server documentation and package reference
+- bootstrap standalone @well-insight/ui component library
+
+### 修复
+
+- disable respect reduced motion for improved layout consistency
+- tighten layout typing and demo typecheck
+- improve dark semantic contrast and layout rem tokens
+- import Scrollbar styles in on-demand component entries
+- restore sider content opacity after MScrollbar
+- leave Dialog and Drawer scroll to app code
+- stop forcing MScrollbar on user-customizable regions
+- register Page styles in global stylesheet
+- support uncontrolled open and slot trigger
+- rename Nuxt module to morya-ui-nuxt for npm publish
+- restore wd compat import paths after bulk rename
+- fix api with component
+- unify suffix icons and Select clearable hover behavior
+- restore DatePicker panel grid after teleport
+- add invalid modifier class alongside error alias
+- improve FloatLabel, Popover, and Slider
+- scroll doc TOC inside WiScrollbar
+- repair guide links and quick-start copy
+- Fix layout header and footer padding axis
+- Expose component-specific CSS variables and adjust layout defaults
+- Add Configurable Layout Sizing And CSS Tokens
+- Improve playground navigation styling
+- Standardize Project Linting And Module Exports
+- rename Wd to Wi in component library and documentation
+
+### 文档
+
+- note style polish and enable docs reduced-motion
+- add AI setup and Agent Skill guides
+- recommend npx @morya-ui/setup for one-shot onboarding
+- move contributor guide out of the public docs site
+- add type sections at end of component docs
+- document shared types and type link conventions
+- document pt props and trim attrs boilerplate
+- add attrs and types guides with updated nav
+- describe Vue 3 support with 3.5+ recommendation
+- polish docs site home, changelog, and branding
+- rebrand as open-source library with logo and README
+- complete Events/Slots sections and remove migration guide
+- add Events and a11y sections to high-traffic components
+- rename Basic sections to 基础用法 in Chinese component docs
+- add accessibility guide for playground
+- expand menu and virtual scroller component pages
+- add deprecated API migration guide
+- Add UI MCP server and docs site links
+- Update install docs to omit explicit Vue dependency
+
+### 变更
+
+- polish component styles and shared base motion
+- refresh docs site visual polish
+- remove redundant package declaration and update peer dependency rules
+- regenerate design tokens for scrollbar-related CSS vars
+- import additional styles for Card and Icon components
+- improve submenu arrow icon and expand behavior
+- update dataset keys from 'mu' to 'm' for consistency
+- add component doc type section tooling
+- add attrs audit and doc maintenance tooling
+- apply hybrid attrs routing across library
+- update documentation links to reflect new GitHub Pages URL
+- rename satellite packages to @morya-ui scope
+- migrate to Wk tokens and remove legacy compat layers
+- rebrand to @wise-kit/ui and reset release baseline to 0.1.1
+- update @roost-design/ui version in pnpm-lock.yaml and enhance SiteHeader component
+- rebrand library to @roost-design/ui and reset version to 0.1.1
+- update catalog generation timestamp and adjust component exports
+- rebrand library from @wex-design/ui to @roost-design/ui
+- reset release baseline to 0.1.1 with fresh changelog
+- update Vue peer dependency and documentation references
+- deploy docs site to GitHub Pages
+- remove admin-manage-project from monorepo
+- update check-docs-drift script and package.json
+- update CHANGELOG for version 0.1.14
+- update Table component to use columns and rows structure
+- update Table component structure and improve functionality
+- import Icon styles across multiple components
+- enhance MobileSidebarShell and DocsView layout with improved flex properties
+- unify clearable API across pickers (phase 6b)
+- phase 6a icon unification and shared picker suffix
+- split vendor chunks and replace eager markdown manifest
+- add unit tests for 16 sub-components
+- migrate remaining overlays to shared placement util
+- add shared menu icon and key utilities
+- replace hardcoded colors with design tokens
+- migrate Select and Dropdown to shared overlay placement
+- extract shared overlay placement utility
+- lazy-load routes and markdown docs
+- streamline MCP tools from 18 to 13
+- Simplify layout components by removing custom scrollbar support and enhancing layout styles
+- clean up whitespace in base.css for consistency
+- Simplify package.json exports by removing development paths for styles and index files
+- restructure release process and update documentation
+
+## Unreleased
+
+### 修复
+
+- Dropdown / SplitButton 传送菜单层级改为 `--m-z-dropdown`（与 Select / Menu 一致）
+- ProgressSpinner wrap 遮罩补局部 z-index，避免被内容盖住
+- 暗色主题语义实心色（success / danger 等）加深，保证与 `--m-color-on-emphasis` 对比可读
+- Button / Badge / 共享进出场 / Dialog / Drawer / Popover / Message / BlockUI 补齐 reduced-motion
+- Layout 默认宽高改为 rem token；ScrollRegion 样式类型与 Scrollbar 对齐
+- 文档站开启 `respect-reduced-motion`；修复 guide manifest 单测
+
+### 变更
+
+- 全库组件样式 polish（Batch 0–6）：状态、token、反馈层级与布局细节
+- Message / Toast `findDuplicate*` 补充显式返回类型
+
+## 0.2.4
+
+### 新功能
+
+- add new route for components demos page
+- theme Tabs, Gallery, Timeline, and Textarea scrolling
+- use MScrollbar in data and panel scroll surfaces
+- theme popup and flyout scroll with MScrollbar
+- use MScrollbar in dialogs, drawers, and popovers
+- route layout scroll through MScrollbar
+- add ScrollBody and FlyoutSubmenu for themed scrolling
+
+### 修复
+
+- leave Dialog and Drawer scroll to app code
+- stop forcing MScrollbar on user-customizable regions
+
+### 变更
+
+- regenerate design tokens for scrollbar-related CSS vars
+- import additional styles for Card and Icon components
+
+## 0.2.3
+
+### 新功能
+
+- add page composition tooling for AI agents
+- add MPage composition components for admin layouts
+
+### 修复
+
+- register Page styles in global stylesheet
+
+## 0.2.2
+
+### 新功能
+
+- add tooltip support for collapsed menu items
+
+### 变更
+
+- improve submenu arrow icon and expand behavior
+- update dataset keys from 'mu' to 'm' for consistency
+
+## 0.2.1
+
+### 破坏性变更
+
+- rebrand WiseKit to morya-ui with M-prefixed public API
+
+### 新功能
+
+- link API table types to doc anchors
+- add hybrid fallthrough attrs helpers
+
+### 修复
+
+- support uncontrolled open and slot trigger
+- rename Nuxt module to morya-ui-nuxt for npm publish
+
+### 文档
+
+- add type sections at end of component docs
+- document shared types and type link conventions
+- document pt props and trim attrs boilerplate
+- add attrs and types guides with updated nav
+
+### 变更
+
+- add component doc type section tooling
+- add attrs audit and doc maintenance tooling
+- apply hybrid attrs routing across library
+- update documentation links to reflect new GitHub Pages URL
+- rename satellite packages to @morya-ui scope
+
+## 0.1.1
+
+`morya-ui` 的初始公开版本（Morya UI），以当前组件库能力为基准。
+
+### 组件（88 个）
+
+- **基础**：Button、ButtonGroup、Icon、Avatar、AvatarGroup、Badge、Chip、Tag、Divider、Skeleton、ProgressBar、ProgressSpinner、BlockUI、ScrollTop
+- **表单**：Input、Textarea、InputNumber、InputPassword、InputOtp、InputTags、InputColor、InputGroup、InputGroupAddon、IconField、FloatLabel、Label、Checkbox、CheckboxGroup、Radio、RadioGroup、Switch、Select、SelectButton、ToggleButton、Slider、Knob、Rating、DatePicker、AutoComplete、CascadeSelect、TreeSelect、FileUpload、Form、FormItem
+- **浮层与对话框**：Dialog、Drawer、Popover、Tooltip、ConfirmDialog、ConfirmPopup、ContextMenu、Dropdown、SplitButton、SpeedDial
+- **数据展示**：Table、Tree、TreeTable、TreeSelect、DataView、VirtualScroller、Timeline、MeterGroup、Terminal、Gallery、Carousel、Inplace
+- **导航与菜单**：Menu、Menubar、MegaMenu、TieredMenu、Breadcrumb、Tabs、Stepper、Pagination、CommandMenu、Dock、Sidebar
+- **布局**：Layout（Header / Sider / Content / Footer）、Grid、Flex、Space、Fluid、Panel、Card、Fieldset、Accordion、Splitter、Toolbar、Listbox、PickList、OrderList、Scrollbar
+
+### 主题与设计令牌
+
+- 亮/暗色主题（`useTheme`、`applyTheme`、`getPreferredTheme`）
+- 密度与动效偏好（`useDensity`、`useMotion`，支持 `prefers-reduced-motion` 与 `data-m-motion`）
+- 基于 `--m-*` CSS 变量的设计令牌体系（颜色、间距、圆角、阴影、边框、布局、树形、时间线、分割面板等）
+- 子树级覆盖：`MConfigProvider` 注入主题、密度、动效与组件默认项
+
+### 全局配置与工具 API
+
+- 插件入口：`MoryaUI` 全量注册、`createMoryaUI` 按需/默认配置
+- 按需构建：`MoryaUIResolver`（配合 `unplugin-vue-components`）
+- ESM 子路径导出（`morya-ui/button` 等），tree-shaking 友好
+- 命令式 API：`useConfirm`、`useToast` / `toast`、`useMessage` / `message`、`useContextMenu`
+- 共享 composable：`useControllable`、`useFieldFeedback`、`useMenuKeyboard`、`useModalOverlay`、`useMId`
+- 国际化：`zhCN`、`enUS`、`mergeLocale`、`useMLocale`、`formatLocale`
+
+### 打包与类型
+
+- 产物：ESM + 类型声明 + 聚合样式 `styles.css`
+- 完整 TypeScript 类型（Props、Emits、Slots、Locale）
+- `sideEffects` 与细粒度 exports，支持按组件引入样式
+
+### 文档站
+
+- 交互式文档站（Markdown + `vue preview` 实时示例）
+- 组件目录、指南（快速上手、主题、配置、SSR、无障碍、MCP）
+- 亮/暗主题切换、中英文切换、全局搜索（CommandMenu）
+- 部署至 GitHub Pages：https://morya-space.github.io/morya-ui/
+
+### 生态包
+
+- **`@morya-ui/nuxt`**：Nuxt 3 模块（样式注入、transpile、客户端 overlay 上下文）
+- **`@morya-ui/mcp`**：MCP 服务，供 AI 客户端检索组件文档、示例与用法建议
+
+### SSR 与框架集成
+
+- 兼容 Nuxt 3、Astro + Vue、Vite SSR 等场景（推荐 Vue 3.5+）
+- 浮层统一挂载与 placement（flip / clamp）策略
+
+### 无障碍
+
+- 表单控件、Tabs、Slider、Switch、MeterGroup、ProgressSpinner 等核心路径的 ARIA 与键盘支持
+- 菜单类组件统一键盘导航（`useMenuKeyboard`）
+- Tree / TreeTable treegrid 语义
+
+### 质量
+
+- 600+ 单元测试用例
+- `check:tokens` / `check:colors` 设计令牌校验