@mureka-fe/ui 1.1.0

package/dist/internal/docs/schema.d.ts

@@ -0,0 +1,107 @@
+export type ComponentStatus = 'stable' | 'beta' | 'deprecated';
+export interface ChangelogEntry {
+    version: string;
+    date: string;
+    changes: string[];
+}
+export interface ComponentSectionMeta {
+    title: string;
+    description: string;
+    demoId: string;
+}
+export interface ApiItem {
+    name: string;
+    signature?: string;
+    type?: string;
+    default?: string;
+    description: string;
+}
+export interface ApiGroup {
+    type: 'props' | 'events' | 'slots' | 'exposes' | 'methods';
+    items: ApiItem[];
+}
+export type GuideKind = 'markdown' | 'custom';
+export interface ComponentDocMeta {
+    id: string;
+    title: {
+        zh: string;
+        en: string;
+    };
+    category: string;
+    order: number;
+    status: ComponentStatus;
+    since: string;
+    summary: string;
+    sections: ComponentSectionMeta[];
+    apis: ApiGroup[];
+    changelog: ChangelogEntry[];
+}
+export interface GuideItem {
+    id: string;
+    title: string;
+    order: number;
+    kind: GuideKind;
+}
+export interface MarkdownGuideDoc extends GuideItem {
+    kind: 'markdown';
+    content: string;
+}
+export interface ColorOverviewSwatch {
+    name: string;
+    token: string;
+    cssVar: string;
+    hex: string;
+    displayValue?: string;
+    usage: string;
+    figmaNodeId?: string;
+}
+export interface ColorOverviewSection {
+    title: string;
+    description: string;
+    layout?: 'line' | 'cards';
+    figmaNodeId?: string;
+    swatches: ColorOverviewSwatch[];
+}
+export interface ColorOverviewGuideDoc extends GuideItem {
+    kind: 'custom';
+    template: 'color-overview';
+    summary: string;
+    sections: ColorOverviewSection[];
+}
+export interface IconGalleryGuideDoc extends GuideItem {
+    kind: 'custom';
+    template: 'icon-gallery';
+    summary: string;
+}
+export type GuideDoc = MarkdownGuideDoc | ColorOverviewGuideDoc | IconGalleryGuideDoc;
+export interface ComponentSectionPage extends ComponentSectionMeta {
+    source: string;
+    sourceHtml: string;
+    sourceLanguage: string;
+}
+export interface ComponentDocPage extends Omit<ComponentDocMeta, 'sections'> {
+    sections: ComponentSectionPage[];
+}
+export interface ManifestCategoryComponent {
+    id: string;
+    title: string;
+    order: number;
+    status: ComponentStatus;
+}
+export interface ManifestCategory {
+    title: string;
+    order: number;
+    components: ManifestCategoryComponent[];
+}
+export interface Manifest {
+    version: string;
+    guides: GuideItem[];
+    categories: ManifestCategory[];
+}
+export interface SnapshotMeta {
+    version: string;
+    commit: string;
+    generatedAt: string;
+    schemaVersion: number;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/internal/docs/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../internal/docs/schema.ts"],"names":[],"mappings":"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"}

package/dist/internal/guides/custom/colors-overview.d.ts

@@ -0,0 +1,4 @@
+import type { ColorOverviewGuideDoc } from '../../docs/schema';
+declare const guide: ColorOverviewGuideDoc;
+export default guide;
+//# sourceMappingURL=colors-overview.d.ts.map

package/dist/internal/guides/custom/colors-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors-overview.d.ts","sourceRoot":"","sources":["../../../../internal/guides/custom/colors-overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,QAAA,MAAM,KAAK,EAAE,qBA8PZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/internal/guides/custom/icons.d.ts

@@ -0,0 +1,4 @@
+import type { IconGalleryGuideDoc } from '../../docs/schema';
+declare const guide: IconGalleryGuideDoc;
+export default guide;
+//# sourceMappingURL=icons.d.ts.map

package/dist/internal/guides/custom/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../internal/guides/custom/icons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,QAAA,MAAM,KAAK,EAAE,mBAQZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/internal/icons/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { IconRecord } from './types';
+export declare const iconRecords: IconRecord[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/internal/icons/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../internal/icons/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,eAAO,MAAM,WAAW,EAAE,UAAU,EA27EnC,CAAC"}

package/dist/internal/icons/types.d.ts

@@ -0,0 +1,21 @@
+export type IconCategory = 'sys' | 'media' | 'instr' | 'social' | 'biz';
+export type IconVariant = 'linear' | 'filled';
+export interface IconRecord {
+    /** 仓库内实际文件名（已重命名为 kebab-case + 扩展名）。 */
+    fileName: string;
+    /** 建议在图标平台上传时使用的 name；与仓库内文件名同步。 */
+    suggestedName: string;
+    /** 一级分类：用于侧边筛选与上传时的分类前缀建议。 */
+    category: IconCategory;
+    /** 视觉风格：linear（默认）/ filled。 */
+    variant: IconVariant;
+    /** 原始文件来源（设计师交付物的相对路径）。 */
+    originalName: string;
+    /** 命名是否需要人工 review（中文 / 数字尾缀重复 / 拼写歧义等）。 */
+    needsReview: boolean;
+    /** review 原因，便于在 UI 上显示。 */
+    reviewReasons: string[];
+    /** 关键词，用于搜索过滤。 */
+    tags: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/icons/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../internal/icons/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,+BAA+B;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB"}

package/dist/llms.txt

@@ -0,0 +1,358 @@
+# @mureka-fe/ui v1.1.0
+
+> AI/LLM-readable reference for the @mureka-fe/ui Vue 3 component library.
+> Read this file before writing UI in a project that depends on this package.
+
+## Setup
+
+```ts
+// Once at app entry:
+import '@mureka-fe/ui/styles.css';
+
+// Then import components as named exports:
+import { MuButton, MuModal } from '@mureka-fe/ui';
+```
+
+## Available components
+
+| Title | id | Summary |
+| --- | --- | --- |
+| Button 按钮 | `button` | 用于触发即时操作，支持主次层级、反色外观、危险状态、胶囊形状与图标模式。 |
+| Message 消息提示 | `message` | 全局展示操作反馈信息，不打断用户操作。 |
+| Dialog 弹窗 | `modal` | 用于承载需要中断当前流程的确认、编辑、危险操作以及结果反馈对话框。提供 form 与 feedback 两种排版形态。 |
+| Tag 标签 | `tag` | 用于展示短文本、状态和设计强绑定标签；v1 为纯展示组件，不承担点击、选中或键盘交互。 |
+| Switch 开关 | `switch` | 用于切换开/关状态，支持受控与非受控、自定义值、异步切换拦截、自定义文案和图标。 |
+| Radio 单选 | `radio` | 用于在一组选项中选择单个值，支持受控与非受控、横向/纵向排列、禁用态和独立使用。 |
+| Tabs 标签页 | `tabs` | 用于在同级内容或模式之间切换，支持 line 与 segment 两种视觉形态、三档尺寸、图标插槽和等宽布局。 |
+
+## Full export list
+
+```ts
+import './styles/index.css';
+
+export { MuButton } from './components/button';
+export { MessageList, message } from './components/message';
+export { MuModal, muModal, openMuModal } from './components/modal';
+export type { ImperativeModalProps } from './components/modal';
+export { MuRadio, MuRadioGroup } from './components/radio';
+export type {
+  RadioGroupDirection,
+  RadioGroupProps,
+  RadioProps,
+  RadioValue,
+} from './components/radio';
+export { MuSwitch } from './components/switch';
+export type {
+  SwitchBeforeChange,
+  SwitchProps,
+  SwitchSize,
+  SwitchType,
+  SwitchValue,
+} from './components/switch';
+export { MuTab, MuTabs } from './components/tabs';
+export type {
+  TabProps,
+  TabValue,
+  TabsAppearance,
+  TabsLayout,
+  TabsProps,
+  TabsSize,
+  TabsVariant,
+} from './components/tabs';
+export { MuTag } from './components/tag';
+```
+
+## Components
+
+### Button 按钮 `button`
+
+Status: stable · Since 1.0.0 · Category: 通用
+
+用于触发即时操作，支持主次层级、反色外观、危险状态、胶囊形状与图标模式。
+
+#### Usage notes
+
+- **基础类型** — 展示 6 种基础视觉类型：primary、tonal、secondary、ghost，以及 primary inverse、secondary inverse。ghost 如需提升内容层级，可额外使用 ghostTextTone。
+- **危险按钮** — 用于删除、清空等高风险操作，首版提供 fill 与 outline 两种危险表达。
+- **按钮尺寸** — 提供 32 / 40 / 48 三档高度，对应 small、medium、large。
+- **按钮形状** — 通过 shape 切换圆角矩形与胶囊形；shape="pill" 搭配 iconOnly 即为圆形图标按钮。
+- **图标组合** — 支持 prefix、suffix、prefix+suffix 以及 iconOnly；纯图标按钮必须提供 aria-label。ghost 如需 icon 与文本都提升为白色，可使用 ghostTextTone="primary"。
+- **加载状态** — loading 会替换 prefix 区域为内置 SVG 加载图标，同时保持文本宽度稳定。
+
+#### Props
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| type | 'primary' \| 'secondary' \| 'tonal' \| 'ghost' | 'primary' | 定义按钮层级。primary 主操作，secondary 次操作，tonal 弱强调，ghost 轻操作。 |
+| status | 'danger' | -- | 附加危险语义。与 type 组合后会覆盖为危险色表现。 |
+| appearance | 'default' \| 'inverse' | 'default' | 定义按钮外观。inverse 用于反色展示。 |
+| ghostTextTone | 'secondary' \| 'primary' | 'secondary' | 仅对 ghost 生效，其他类型会忽略该属性。控制 ghost 按钮内 icon 与文本的层级；primary 会提升为白色内容。 |
+| size | 'small' \| 'medium' \| 'large' | 'medium' | 定义按钮高度、内边距和图标尺寸。 |
+| shape | 'rectangular' \| 'pill' | 'rectangular' | 定义按钮外形。pill 为胶囊形，与 iconOnly 组合时表现为圆形图标按钮。 |
+| disabled | boolean | false | 禁用态下按钮不可点击，并显示对应的禁用视觉。 |
+| loading | boolean | false | 加载态不可点击，prefix 区域切换为内置 SVG 加载图标，文本保持不变。 |
+| iconOnly | boolean | false | 声明为纯图标按钮。必须提供 aria-label，且不能与 prefix / suffix 同时使用。 |
+| nativeType | 'button' \| 'submit' \| 'reset' | 'button' | 透传给原生 button 的 type 属性。 |
+
+#### Slots
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| default | VNode | -- | 按钮主体内容。文本按钮承载文案，iconOnly 场景承载图标节点。 |
+| prefix | VNode | -- | 前置图标或补充内容。loading 时会被内置加载图标替换。 |
+| suffix | VNode | -- | 后置图标或补充内容。iconOnly 模式下不可使用。 |
+
+#### Events
+
+| name | signature | description |
+| --- | --- | --- |
+| click | (event: MouseEvent) => void | 点击按钮时触发；disabled 或 loading 状态下不会触发。 |
+
+### Message 消息提示 `message`
+
+Status: stable · Since 1.0.0 · Category: 反馈
+
+全局展示操作反馈信息，不打断用户操作。
+
+#### Usage notes
+
+- **基本用法** — 支持 success / warning / loading / error / danger 五种通知状态，新消息会加入顶部消息队列。
+- **自定义图标** — 通过 icon 自定义提示图标，支持内联 SVG 字符串或 Vue 组件。
+- **可关闭** — 设置 closable 显示关闭按钮；配合 duration: 0 可保持常驻，直到用户手动关闭。
+
+#### Methods
+
+| name | signature | description |
+| --- | --- | --- |
+| message.success | (text: string \| { title: string; description?: string; duration?: number; closable?: boolean; resetOnHover?: boolean; icon?: string \| Component }) => { close: () => void } | 展示成功提示，对应 Export Complete 的青色通知卡片。 |
+| message.warning | (text: string \| { title: string; description?: string; duration?: number; closable?: boolean; resetOnHover?: boolean; icon?: string \| Component }) => { close: () => void } | 展示警告提示。 |
+| message.loading | (text: string \| { title: string; description?: string; duration?: number; closable?: boolean; resetOnHover?: boolean; icon?: string \| Component }) => { close: () => void } | 展示加载中提示。 |
+| message.error | (text: string \| { title: string; description?: string; duration?: number; closable?: boolean; resetOnHover?: boolean; icon?: string \| Component }) => { close: () => void } | 展示业务错误提示，可恢复。 |
+| message.danger | (text: string \| { title: string; description?: string; duration?: number; closable?: boolean; resetOnHover?: boolean; icon?: string \| Component }) => { close: () => void } | 展示系统级危险错误提示，不可恢复。 |
+
+### Dialog 弹窗 `modal`
+
+Status: stable · Since 1.0.0 · Category: 反馈
+
+用于承载需要中断当前流程的确认、编辑、危险操作以及结果反馈对话框。提供 form 与 feedback 两种排版形态。
+
+#### Usage notes
+
+- **何时用 form / 何时用 feedback** — form 用于"用户主动发起的操作弹窗"（创建、编辑、确认动作）：标题保持中性白色，CTA 是要被强调的下一步动作（cyan 实色或 danger 描边）。feedback 用于"系统/动作产生的状态反馈"（操作完成、错误提示、信息说明）：标题本身是状态语义，按 status 染色；CTA 退化为退出/继续，使用描边形态减轻视觉权重。判断口径：标题是动词短语用 form，标题是状态/结果短语用 feedback。下面表格列出 6 种典型组合。
+- **基础用法（form + default）** — 声明式控制 Dialog 显隐，默认提供标题、内容区和双按钮 footer。
+- **危险操作（form + danger）** — form 形态下的 danger 适用于表单内的删除/移除等不可逆动作。标题保持白色，仅 OK 按钮切换为红色描边。
+- **反馈形态（feedback）** — feedback 形态用于操作结果反馈。标题按 status 染色（success 绿 / danger 红 / default 白），OK 按钮统一为对应颜色的描边。默认隐藏 Cancel。
+- **反馈形态保留 Cancel（双按钮）** — 需要在反馈弹窗里给用户撤销/继续的选择时，显式传 hideCancel=false 即可恢复双按钮排版。
+- **函数式调用** — 通过 muModal.confirm / muModal.success / muModal.danger / openMuModal 直接弹出对话框，返回 Promise<boolean>：OK 解析为 true，Cancel/Close/Esc/Mask 解析为 false。
+- **尺寸** — 提供 medium 与 large 两档尺寸，large 适用于需要更大内容承载区的 Dialog。
+
+#### Props
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| visible | boolean | false | 控制弹窗显隐，支持 `v-model:visible` 双向绑定。 |
+| title | string | '' | 弹窗标题文案。 |
+| width | string | size preset | 覆盖默认尺寸预设的面板宽度。 |
+| variant | 'form' \| 'feedback' | 'form' | form 用于操作弹窗（CTA 强调）；feedback 用于状态反馈（标题按 status 染色 + OK 描边 + 默认隐藏 Cancel）。详见"何时用"章节。 |
+| status | 'default' \| 'success' \| 'danger' | 'default' | feedback 形态下决定标题颜色与 OK 描边色；form 形态下仅 danger 影响 OK 按钮（保持现有行为）。 |
+| size | 'medium' \| 'large' | 'medium' | 定义弹窗面板尺寸。 |
+| maskClosable | boolean | true | 点击遮罩层时是否关闭弹窗。 |
+| escToClose | boolean | true | 按下 `Escape` 时是否关闭弹窗。 |
+| closable | boolean | true | 是否展示右上角关闭按钮。 |
+| okText | string | 'Confirm' | 确认按钮文案。 |
+| cancelText | string | 'Cancel' | 取消按钮文案。 |
+| okLoading | boolean | false | 确认按钮加载态。 |
+| hideOk | boolean | false | 隐藏默认确认按钮。 |
+| hideCancel | boolean | form: false / feedback: true | 隐藏取消按钮。form 形态默认 false（双按钮），feedback 形态默认 true（单 CTA）。显式传值仍优先。 |
+
+#### Slots
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| default | VNode | -- | 弹窗主体内容区域。 |
+| title | VNode | -- | 覆盖默认标题区域。 |
+| footer | VNode | -- | 完全接管底部操作区。 |
+
+#### Events
+
+| name | signature | description |
+| --- | --- | --- |
+| update:visible | (value: boolean) => void | 显隐状态变化时触发。 |
+| ok | (event: MouseEvent) => void | 点击确认按钮时触发。函数式调用会自动 resolve(true)。 |
+| cancel | (event: MouseEvent) => void | 点击取消按钮或遮罩层关闭时触发。函数式调用会自动 resolve(false)。 |
+| close | () => void | 点击右上角关闭按钮或按下 `Escape` 关闭时触发。函数式调用会自动 resolve(false)。 |
+
+#### Methods
+
+| name | signature | description |
+| --- | --- | --- |
+| openMuModal | (props: ImperativeModalProps) => Promise<boolean> | 通用函数式入口，透传所有 ModalProps（除 visible）。OK→true，Cancel/Close/Mask/Esc→false。 |
+| muModal.show | (props) => Promise<boolean> | 等价于 openMuModal。 |
+| muModal.confirm | (props) => Promise<boolean> | 透传所有 props，默认 form 形态；常用于操作前确认。 |
+| muModal.success | (props) => Promise<boolean> | 强制 variant=feedback, status=success，常用于操作完成反馈。 |
+| muModal.danger | (props) => Promise<boolean> | 强制 variant=feedback, status=danger，常用于错误/失败反馈。 |
+
+### Tag 标签 `tag`
+
+Status: stable · Since 1.0.0 · Category: 通用
+
+用于展示短文本、状态和设计强绑定标签；v1 为纯展示组件，不承担点击、选中或键盘交互。
+
+#### Usage notes
+
+- **基础组合** — 通过 tone 与 variant 组合表达常规标签语义，组合范围与设计稿保持收敛。
+- **尺寸与形状** — size 只描述几何规格，shape 控制圆角矩形或胶囊形。
+- **图标插槽** — 基础标签支持 prefix 与 suffix 插槽，用于在文本前后放置 14px 图标。
+- **强绑定样式** — preset 固化 New、Soon、Beta、1 Free 与 Details 等设计强绑定样式。
+- **Variant 对照** — tonal 表示半透明底加弱描边，避免将 soft 与 outline 作为可叠加语义。
+
+#### Props
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| preset | 'new' \| 'new-mini' \| 'soon' \| 'beta' \| 'free' \| 'details' | -- | 使用固定设计样式。提供 preset 后会在类型层禁止 tone、variant、size 和 shape。 |
+| tone | 'neutral' \| 'cyan' \| 'yellow' | 'neutral' | 基础标签的色彩语义。不同 tone 只开放设计稿支持的 variant。 |
+| variant | 'soft' \| 'outline' \| 'tonal' \| 'solid' | tone default | 基础标签的视觉强度。neutral 支持 soft/outline/tonal，cyan 支持 solid/outline/tonal，yellow 仅支持 outline。 |
+| size | 'mini' \| 'small' \| 'medium' \| 'large' | 'small' | 定义标签高度、字号和水平内边距，不承载使用场景语义。 |
+| shape | 'rounded' \| 'pill' | 'rounded' | 定义标签外形。pill 用于计数、音乐风格等胶囊标签。 |
+
+#### Slots
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| default | VNode | -- | 基础标签内容。preset 标签内容固定，不读取默认插槽。 |
+| prefix | VNode | -- | 基础标签前置图标插槽，建议使用 14px 图标并继承 currentColor。 |
+| suffix | VNode | -- | 基础标签后置图标插槽，建议使用 14px 图标并继承 currentColor。 |
+
+### Switch 开关 `switch`
+
+Status: stable · Since 1.0.0 · Category: 通用
+
+用于切换开/关状态，支持受控与非受控、自定义值、异步切换拦截、自定义文案和图标。
+
+#### Usage notes
+
+- **基础用法** — 通过 v-model 绑定开关状态，默认视觉对齐设计稿的圆形开关。
+- **开关类型** — 提供 circle、round、line 三种类型；line 只保留轨道和滑块，不显示文案。
+- **尺寸** — 提供 medium 与 small 两档尺寸，small 不显示状态文案。
+- **禁用与加载** — disabled 使用整体透明度表达不可用；loading 阻止交互并展示加载图标。
+- **自定义文案** — 通过 checked / unchecked 插槽或 checkedText / uncheckedText 自定义状态文案。
+- **自定义图标** — 通过 checked-icon / unchecked-icon 插槽定制滑块上的状态图标。
+- **异步切换** — beforeChange 可返回 false 或 Promise 阻止切换，适合二次确认和远程校验。
+
+#### Props
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| model-value (v-model) | string \| number \| boolean | -- | 绑定值。传入非 undefined 值时组件进入受控模式。 |
+| default-checked | boolean | false | 非受控模式下的默认选中状态。 |
+| disabled | boolean | false | 是否禁用。禁用后不可交互，并使用 0.4 透明度。 |
+| loading | boolean | false | 是否为加载中状态。加载中不可交互，并在滑块中显示加载图标。 |
+| type | 'circle' \| 'round' \| 'line' | 'circle' | 开关类型。circle 为默认胶囊形，round 为圆角矩形，line 为线形。 |
+| size | 'small' \| 'medium' | 'medium' | 开关尺寸。small 不显示 checked / unchecked 文案。 |
+| checked-value | string \| number \| boolean | true | 选中时发出的值。 |
+| unchecked-value | string \| number \| boolean | false | 未选中时发出的值。 |
+| checked-color | string | -- | 选中时的开关颜色，同步影响轨道、描边、滑块和发光。 |
+| unchecked-color | string | -- | 未选中时的轨道颜色。 |
+| before-change | (newValue: string \| number \| boolean) => Promise<boolean \| void> \| boolean \| void | -- | 状态改变前的钩子。返回 false、Promise resolve false 或 Promise reject 时取消切换。 |
+| checked-text | string | -- | 打开状态文案。type='line' 和 size='small' 时不生效。 |
+| unchecked-text | string | -- | 关闭状态文案。type='line' 和 size='small' 时不生效。 |
+
+#### Events
+
+| name | signature | description |
+| --- | --- | --- |
+| change | (value: boolean \| string \| number, originalEvent: Event \| null) => void | 值改变时触发。异步 beforeChange 通过后仍透传触发切换时的 originalEvent，但该事件可能已经不在当前 frame。 |
+| focus | (event: FocusEvent) => void | 组件获得焦点时触发。 |
+| blur | (event: FocusEvent) => void | 组件失去焦点时触发。 |
+
+#### Slots
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| checked-icon | VNode | -- | 打开状态时，滑块上的图标。loading 时会被加载图标替换。 |
+| unchecked-icon | VNode | -- | 关闭状态时，滑块上的图标。loading 时会被加载图标替换。 |
+| checked | VNode | -- | 打开状态时的文案。type='line' 和 size='small' 时不生效。 |
+| unchecked | VNode | -- | 关闭状态时的文案。type='line' 和 size='small' 时不生效。 |
+
+### Radio 单选 `radio`
+
+Status: stable · Since 1.0.0 · Category: 通用
+
+用于在一组选项中选择单个值，支持受控与非受控、横向/纵向排列、禁用态和独立使用。
+
+#### Usage notes
+
+- **基础用法** — 通过 MuRadioGroup 与 v-model 管理单选值，默认样式对齐 Figma 48px 输入场景。
+- **排列方向** — direction 支持 horizontal 与 vertical；横向组间距为 16px。
+- **禁用状态** — Group disabled 会禁用整组；单个 Radio 也可以独立 disabled。
+- **独立使用** — 不包裹 Group 时，多个 Radio 可以共享同一个 v-model 与 name 自行组成选择关系。
+
+#### Props
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| model-value (v-model) | string \| number \| boolean | -- | Radio 的绑定值。传入非 undefined 值时进入受控模式。 |
+| value | string \| number \| boolean | true | 当前 Radio 被选中时发出的值。 |
+| default-checked | boolean | false | 非受控模式下的默认选中状态，仅对独立 Radio 生效。 |
+| disabled | boolean | false | 禁用当前 Radio。Group disabled 会同时禁用组内所有 Radio。 |
+| name | string | -- | 透传给原生 radio input 的 name。Group name 会优先透传给子项。 |
+| default-value | string \| number \| boolean | -- | Group 非受控模式下的默认选中值。 |
+| direction | 'horizontal' \| 'vertical' | 'horizontal' | Group 排列方向。 |
+
+#### Events
+
+| name | signature | description |
+| --- | --- | --- |
+| change | (value: string \| number \| boolean, originalEvent: Event) => void | 值改变时触发。Group 内选择由 Group 触发，独立 Radio 由自身触发。 |
+| focus | (event: FocusEvent) => void | Radio 原生 input 获得焦点时触发。 |
+| blur | (event: FocusEvent) => void | Radio 原生 input 失去焦点时触发。 |
+
+#### Slots
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| default | VNode | -- | Radio 标签内容。 |
+
+### Tabs 标签页 `tabs`
+
+Status: stable · Since 1.0.0 · Category: 通用
+
+用于在同级内容或模式之间切换，支持 line 与 segment 两种视觉形态、三档尺寸、图标插槽和等宽布局。
+
+#### Usage notes
+
+- **Line 标签** — line 固定使用 cyan 激活色，不支持 appearance；第一版仅实现 tab header。
+- **Segment White** — segment 的 white appearance 使用浅色激活填充，适合无图标的基础切换。
+- **Segment Ghost** — ghost appearance 使用半透明填充，并支持每个 MuTab 的 prefix 与 suffix 插槽。
+- **尺寸** — small / medium / large 对应 32 / 40 / 48 三档高度。
+- **等宽布局** — layout="equal" 让 segment item 平分容器；两个 tab 只是 item 数量变化，不是新分类。
+- **禁用状态** — Tabs disabled 会禁用整组；单个 MuTab 也可以独立 disabled。
+
+#### Props
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| model-value (v-model) | string \| number | -- | 当前激活值。传入非 undefined 值时进入受控模式。 |
+| default-value | string \| number | -- | 非受控模式下的默认激活值。 |
+| variant | 'line' \| 'segment' | 'line' | 视觉形态。line 为文字加下划线；segment 为容器内填充选项。 |
+| appearance | 'white' \| 'ghost' | 'white' | 仅在 variant="segment" 时可用，表示 segment 的填充风格；不是 Tag 的 tone 色调体系。 |
+| size | 'small' \| 'medium' \| 'large' | 'medium' | 定义 Tabs 高度、字号、圆角、内边距和图标尺寸。 |
+| layout | 'content' \| 'equal' | 'content' | content 按内容宽度撑开；equal 让 item 等宽平分容器。 |
+| disabled | boolean | false | 禁用整组 Tabs，组内 MuTab 不可选择。 |
+| value | string \| number | -- | MuTab 的唯一值，用于匹配当前激活项。 |
+
+#### Events
+
+| name | signature | description |
+| --- | --- | --- |
+| change | (value: string \| number, originalEvent: Event) => void | 激活值变化时触发。 |
+| click | (event: MouseEvent) => void | MuTab 按钮点击时触发；disabled 状态不会触发。 |
+
+#### Slots
+
+| name | type | default | description |
+| --- | --- | --- | --- |
+| default | VNode | -- | MuTabs 默认插槽承载 MuTab；MuTab 默认插槽承载标签文本。 |
+| prefix | VNode | -- | MuTab 前置图标插槽，图标尺寸随 Tabs size 变化。 |
+| suffix | VNode | -- | MuTab 后置图标插槽，图标尺寸随 Tabs size 变化。 |

package/dist/src/components/button/Button.vue.d.ts

@@ -0,0 +1,32 @@
+import type { ButtonProps } from './button.types';
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
+type __VLS_Slots = {} & {
+    prefix?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_3) => any;
+} & {
+    suffix?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<ButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<ButtonProps> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    type: import("./button.types").ButtonType;
+    appearance: import("./button.types").ButtonAppearance;
+    ghostTextTone: import("./button.types").ButtonGhostTextTone;
+    size: import("./button.types").ButtonSize;
+    shape: import("./button.types").ButtonShape;
+    disabled: boolean;
+    loading: boolean;
+    iconOnly: boolean;
+    nativeType: import("./button.types").ButtonNativeType;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=Button.vue.d.ts.map

package/dist/src/components/button/Button.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/button/Button.vue"],"names":[],"mappings":"AAsaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAiPlD,QAAA,IAAI,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAW,CAAE;AAC9D,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC3C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC5C;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AA0B9C,QAAA,MAAM,eAAe;;;;;;;;;;;;;;6EAQnB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/src/components/button/__docs__/demos/basic.demo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=basic.demo.vue.d.ts.map

package/dist/src/components/button/__docs__/demos/basic.demo.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.demo.vue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/button/__docs__/demos/basic.demo.vue"],"names":[],"mappings":";AA4IA,wBAKG"}

package/dist/src/components/button/__docs__/demos/danger.demo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=danger.demo.vue.d.ts.map

package/dist/src/components/button/__docs__/demos/danger.demo.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"danger.demo.vue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/button/__docs__/demos/danger.demo.vue"],"names":[],"mappings":";AAmIA,wBAKG"}

package/dist/src/components/button/__docs__/demos/icon.demo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=icon.demo.vue.d.ts.map

package/dist/src/components/button/__docs__/demos/icon.demo.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.demo.vue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/button/__docs__/demos/icon.demo.vue"],"names":[],"mappings":";AA0QA,wBAKG"}

package/dist/src/components/button/__docs__/demos/loading.demo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=loading.demo.vue.d.ts.map

package/dist/src/components/button/__docs__/demos/loading.demo.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.demo.vue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/button/__docs__/demos/loading.demo.vue"],"names":[],"mappings":";AA6IA,wBAKG"}

package/dist/src/components/button/__docs__/demos/shape.demo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=shape.demo.vue.d.ts.map

package/dist/src/components/button/__docs__/demos/shape.demo.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.demo.vue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/button/__docs__/demos/shape.demo.vue"],"names":[],"mappings":";AA0NA,wBAKG"}

package/dist/src/components/button/__docs__/demos/size.demo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=size.demo.vue.d.ts.map

package/dist/src/components/button/__docs__/demos/size.demo.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.demo.vue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/button/__docs__/demos/size.demo.vue"],"names":[],"mappings":";AAqJA,wBAKG"}

package/dist/src/components/button/__docs__/meta.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentDocMeta } from '../../../../internal/docs/schema';
+declare const meta: ComponentDocMeta;
+export default meta;
+//# sourceMappingURL=meta.d.ts.map

package/dist/src/components/button/__docs__/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../../../src/components/button/__docs__/meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,QAAA,MAAM,IAAI,EAAE,gBA8IX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/src/components/button/button.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=button.spec.d.ts.map

package/dist/src/components/button/button.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.spec.d.ts","sourceRoot":"","sources":["../../../../src/components/button/button.spec.ts"],"names":[],"mappings":""}