@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/button/ButtonGroup.svelte

@@ -1,7 +1,13 @@
 <!--
-  ButtonGroup — 把多个 Button 横向拼接：相邻按钮共享边框、圆角只在两端。
-  组级默认（size/type/theme/disabled）经 setContext 透传给组内 Button，
-  仅作为「未显式设置」的回退（Button 显式 prop 始终优先），不破坏 Button API。
+  ButtonGroup — 横向拼接多个 Button（对齐 Semi buttonGroup.tsx + button.scss `-group`）。
+  组级默认（size/type/theme/disabled/colorful）经 setContext 透传给组内 Button，
+  仅作为「未显式设置」的回退（Button 显式 prop 始终优先）。
+
+  分隔线取舍（对齐 Semi 视觉，见交付说明）：
+    Semi getInnerWithLine 读每个子 Button 的 type/theme 生成 <span class="...group-line-{type}"> 分隔条。
+    但该 span 的可见部分只是内部 ::before（1px × 20px，恒为 group-border-default 色，per-type 底色被 1px 遮住不可见）。
+    Svelte 无法读 children 的 props，故用相邻 button 的 ::before 伪元素复刻该 1px 分隔条，
+    视觉与 Semi 一致；outline 主题下不画分隔条、改用 Semi 的 border 叠边方案（组级 theme 控制）。
 -->
 <script lang="ts">
   import { setContext, type Snippet } from 'svelte';
@@ -41,8 +47,7 @@
     children,
   }: Props = $props();
 
-  // 透传组级默认给组内 Button（getButtonGroupContext 读取）。
-  // 用 getter 暴露 live 值，使组内 Button 始终读到最新的组级默认（context 本身不可重赋值）。
+  // 透传组级默认给组内 Button（getButtonGroupContext 读取），getter 暴露 live 值。
   const ctx: ButtonGroupContext = {
     get size() {
       return size;
@@ -61,47 +66,88 @@
     },
   };
   setContext(BUTTON_GROUP_CTX, ctx);
+
+  // outline 主题走 border 叠边（对齐 Semi -outline:not(:last-child) 方案），非 outline 画分隔条。
+  const isOutline = $derived(theme === 'outline');
 </script>
 
-<div class={['cd-button-group', className].filter(Boolean).join(' ')} {style} role="group" aria-label={ariaLabel}>
+<div
+  class={['cd-button-group', isOutline && 'cd-button-group-outline', className].filter(Boolean).join(' ')}
+  {style}
+  role="group"
+  aria-label={ariaLabel}
+>
   {@render children?.()}
 </div>
 
 <style>
+  /* 对齐 Semi .semi-button-group：flex 排布，组内 button 去内外边距/圆角，首末补圆角。 */
   .cd-button-group {
     display: inline-flex;
+    flex-wrap: wrap;
     align-items: center;
   }
-  /* 相邻按钮共享边框：除首个外左移 1px 叠边，圆角只保留两端。 */
   .cd-button-group :global(.cd-button) {
+    margin: 0;
+    padding-left: 0;
+    padding-right: 0;
     border-radius: 0;
     position: relative;
   }
-  .cd-button-group :global(.cd-button:not(:first-child)) {
-    margin-inline-start: -1px;
+  /* content 补回被清掉的水平内边距（对齐 Semi -group > .button .button-content padding）。 */
+  .cd-button-group :global(.cd-button) :global(.cd-button-content) {
+    padding-left: var(--cd-spacing-button-default-paddingleft);
+    padding-right: var(--cd-spacing-button-default-paddingright);
+  }
+  .cd-button-group :global(.cd-button-size-large) :global(.cd-button-content) {
+    padding-left: var(--cd-spacing-button-large-paddingleft);
+    padding-right: var(--cd-spacing-button-large-paddingright);
+  }
+  .cd-button-group :global(.cd-button-size-small) :global(.cd-button-content) {
+    padding-left: var(--cd-spacing-button-small-paddingleft);
+    padding-right: var(--cd-spacing-button-small-paddingright);
+  }
+  /* icon-only：content 用 iconOnly 内边距（对齐 Semi -group -with-icon-only .content padding）。 */
+  .cd-button-group :global(.cd-button-with-icon-only) :global(.cd-button-content) {
+    padding-left: var(--cd-spacing-button-icononly-default-paddingleft);
+    padding-right: var(--cd-spacing-button-icononly-default-paddingright);
+  }
+  .cd-button-group :global(.cd-button-with-icon-only.cd-button-size-small) :global(.cd-button-content) {
+    padding-left: var(--cd-spacing-button-icononly-small-paddingleft);
+    padding-right: var(--cd-spacing-button-icononly-small-paddingright);
+  }
+  .cd-button-group :global(.cd-button-with-icon-only.cd-button-size-large) :global(.cd-button-content) {
+    padding-left: var(--cd-spacing-button-icononly-large-paddingleft);
+    padding-right: var(--cd-spacing-button-icononly-large-paddingright);
   }
   .cd-button-group :global(.cd-button:first-child) {
-    border-start-start-radius: var(--cd-button-radius);
-    border-end-start-radius: var(--cd-button-radius);
+    border-top-left-radius: var(--cd-radius-button-group);
+    border-bottom-left-radius: var(--cd-radius-button-group);
   }
   .cd-button-group :global(.cd-button:last-child) {
-    border-start-end-radius: var(--cd-button-radius);
-    border-end-end-radius: var(--cd-button-radius);
+    border-top-right-radius: var(--cd-radius-button-group);
+    border-bottom-right-radius: var(--cd-radius-button-group);
   }
-  /* hover/focus 的按钮浮到相邻按钮之上，保证边框/聚焦环完整可见。 */
+  /* hover/focus 浮到相邻之上，保证边框/聚焦环完整可见。 */
   .cd-button-group :global(.cd-button:hover),
   .cd-button-group :global(.cd-button:focus-visible) {
     z-index: 1;
   }
-  /* 无边框主题（solid/light）下，用细分隔线区隔相邻按钮。 */
-  .cd-button-group :global(.cd-button:not(:first-child))::before {
+  /* 分隔条（对齐 Semi group-line ::before：1px × 20px，group-border 色）。非 outline 主题插入。 */
+  .cd-button-group:not(.cd-button-group-outline) :global(.cd-button:not(:first-child))::before {
     content: '';
     position: absolute;
-    inset-block: 0;
+    top: 50%;
     inset-inline-start: 0;
-    width: 1px;
-    background: var(--cd-button-group-divider);
-    opacity: 0.5;
+    transform: translateY(-50%);
+    width: var(--cd-width-button-group-border);
+    height: var(--cd-height-button-group-line-default);
+    background-color: var(--cd-color-button-group-border-default);
     pointer-events: none;
   }
+  /* outline 主题：相邻 button 透明右边框 + 负外边距叠边（对齐 Semi -outline:not(:last-child)）。 */
+  .cd-button-group-outline :global(.cd-button:not(:last-child)) {
+    border-right-color: transparent;
+    margin-right: calc(-1 * var(--cd-width-button-outline-border));
+  }
 </style>

package/dist/button/ButtonGroup.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ButtonGroup.svelte.d.ts","sourceRoot":"","sources":["../../src/button/ButtonGroup.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAGtB,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiDH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ButtonGroup.svelte.d.ts","sourceRoot":"","sources":["../../src/button/ButtonGroup.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAGtB,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAmDH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/button/SplitButtonGroup.svelte

@@ -1,127 +1,90 @@
 <!--
-  SplitButtonGroup — 分裂按钮：左侧主 Button + 右侧带下拉箭头的小 Button。
-  右侧小按钮点击触发 Dropdown（复用现有 Dropdown 的 items API / menu snippet）。
-  视觉上两者拼接、中间细分隔；主按钮 type/theme 透传给两侧。
+  SplitButtonGroup — 纯容器（严格对齐 Semi splitButtonGroup.tsx）。
+  破坏性重写：删除自造的 items/position/onSelect/menu/Dropdown 集成，改为纯 role=group 容器。
+  给首个/末个 <button> 加 cd-button-first / cd-button-last class（对齐 Semi 的 MutationObserver 方案，
+  Svelte 用 action + MutationObserver 等价实现，兼容动态增删 button）。
+  典型用法：内部放 Button + Dropdown(含箭头 Button)，见官方 demo。
 -->
 <script lang="ts">
   import type { Snippet } from 'svelte';
-  import Button from './Button.svelte';
-  import { Dropdown } from '../dropdown/index.js';
-  import type { DropdownItem } from '../dropdown/types.js';
-  import type { Placement } from '@chenzy-design/core';
-  import type { ButtonType, ButtonTheme, ButtonSize } from './context.js';
 
   interface Props {
-    type?: ButtonType;
-    theme?: ButtonTheme;
-    size?: ButtonSize;
-    disabled?: boolean;
-    loading?: boolean;
-    /** 下拉菜单数据项（透传给 Dropdown.items）。 */
-    items?: DropdownItem[];
-    /** 下拉浮层位置（透传给 Dropdown.position）。 */
-    position?: Placement;
-    /** 下拉箭头按钮的 aria-label（无文字按钮必填）。 */
-    triggerAriaLabel?: string;
-    /** 选中下拉项回调。 */
-    onSelect?: (key: string | number) => void;
-    /** 主按钮点击回调。 */
-    onclick?: (e: MouseEvent) => void;
     /** 分裂按钮组语义标签（root aria-label，对齐 Semi）。 */
     ariaLabel?: string;
     /** 根元素自定义类名（透传）。 */
     class?: string;
     /** 根元素自定义内联样式（透传）。 */
     style?: string;
-    /** 左侧主按钮内容。 */
+    /** 分裂按钮内容（Button + Dropdown 等）。 */
     children?: Snippet;
-    /** 自定义下拉菜单体（替代 items）。 */
-    menu?: Snippet;
   }
 
-  let {
-    type = 'primary',
-    theme = 'solid',
-    size = 'default',
-    disabled = false,
-    loading = false,
-    items = [],
-    position = 'bottomEnd',
-    triggerAriaLabel = '更多操作',
-    onSelect,
-    onclick,
-    ariaLabel,
-    class: className,
-    style,
-    children,
-    menu,
-  }: Props = $props();
+  let { ariaLabel, class: className, style, children }: Props = $props();
+
+  // 对齐 Semi componentDidMount + MutationObserver：为首/末 button 加圆角 class。
+  function splitClasses(node: HTMLElement) {
+    const apply = () => {
+      const buttons = node.querySelectorAll('button');
+      const first = buttons[0];
+      const last = buttons[buttons.length - 1];
+      // 先清旧标记再打新标记，避免动态增删后残留。
+      node.querySelectorAll('.cd-button-first').forEach((el) => el.classList.remove('cd-button-first'));
+      node.querySelectorAll('.cd-button-last').forEach((el) => el.classList.remove('cd-button-last'));
+      first?.classList.add('cd-button-first');
+      last?.classList.add('cd-button-last');
+    };
+    apply();
+    const observer = new MutationObserver((mutations) => {
+      for (const m of mutations) {
+        if (
+          (m.type === 'attributes' && m.attributeName === 'class') ||
+          (m.type === 'childList' &&
+            Array.from(m.addedNodes).some((n) => n.nodeName === 'BUTTON'))
+        ) {
+          apply();
+          break;
+        }
+      }
+    });
+    observer.observe(node, { attributes: true, childList: true, subtree: true });
+    return {
+      destroy() {
+        observer.disconnect();
+      },
+    };
+  }
 </script>
 
-<div class={['cd-split-button', className].filter(Boolean).join(' ')} {style} role="group" aria-label={ariaLabel}>
-  <Button {type} {theme} {size} {disabled} {loading} onclick={(e) => onclick?.(e)}>
-    {@render children?.()}
-  </Button>
-  <!-- 有自定义 menu 时把它作为 children 透传给 Dropdown；
-       否则不传 children，让 Dropdown 走内置 items 渲染分支。
-       注意：标签体内即便是空 {#if} 也会被 Svelte 收集成 children snippet，
-       从而覆盖 items 导致菜单为空，故必须按 menu 是否存在分叉两个调用。 -->
-  {#if menu}
-    <Dropdown
-      trigger="click"
-      {items}
-      {position}
-      {disabled}
-      onSelect={(key) => onSelect?.(key)}
-    >
-      {#snippet triggerContent()}
-        <Button {type} {theme} {size} {disabled} ariaLabel={triggerAriaLabel} icon={caret}></Button>
-      {/snippet}
-      {@render menu()}
-    </Dropdown>
-  {:else}
-    <Dropdown
-      trigger="click"
-      {items}
-      {position}
-      {disabled}
-      onSelect={(key) => onSelect?.(key)}
-    >
-      {#snippet triggerContent()}
-        <Button {type} {theme} {size} {disabled} ariaLabel={triggerAriaLabel} icon={caret}></Button>
-      {/snippet}
-    </Dropdown>
-  {/if}
+<div
+  class={['cd-button-split', className].filter(Boolean).join(' ')}
+  {style}
+  role="group"
+  aria-label={ariaLabel}
+  use:splitClasses
+>
+  {@render children?.()}
 </div>
 
-{#snippet caret()}
-  <svg viewBox="0 0 24 24" width="1em" height="1em" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
-    <path d="m6 9 6 6 6-6" />
-  </svg>
-{/snippet}
-
 <style>
-  .cd-split-button {
-    display: inline-flex;
-    align-items: center;
+  /* 对齐 Semi splitButtonGroup.scss。 */
+  .cd-button-split {
+    display: inline-block;
   }
-  /* 拼接：主按钮右侧去圆角、箭头按钮左侧去圆角并叠边。 */
-  .cd-split-button :global(.cd-button:first-child) {
-    border-start-end-radius: 0;
-    border-end-end-radius: 0;
+  .cd-button-split :global(.cd-button) {
+    border-radius: 0;
+    margin-right: 1px;
   }
-  .cd-split-button :global(.cd-dropdown) {
-    display: inline-flex;
-    margin-inline-start: -1px;
+  .cd-button-split :global(.cd-button-first) {
+    border-top-left-radius: var(--cd-radius-button-splitbuttongroup-first-topleft);
+    border-bottom-left-radius: var(--cd-radius-button-splitbuttongroup-first-bottomleft);
   }
-  .cd-split-button :global(.cd-dropdown .cd-button) {
-    border-start-start-radius: 0;
-    border-end-start-radius: 0;
-    position: relative;
-    /* 中间细分隔线 */
-    box-shadow: inset 1px 0 0 0 var(--cd-button-group-divider);
+  .cd-button-split :global(.cd-button-last) {
+    border-top-right-radius: var(--cd-radius-button-splitbuttongroup-last-topright);
+    border-bottom-right-radius: var(--cd-radius-button-splitbuttongroup-last-bottomright);
+    margin-right: unset;
   }
-  .cd-split-button :global(.cd-dropdown__trigger) {
-    display: inline-flex;
+  /* 因上面 border-radius:0 覆盖了 borderless active 背景，hover 时补回（对齐 Semi）。 */
+  .cd-button-split:hover :global(.cd-button-borderless:active) {
+    background-color: var(--cd-color-button-borderless-bg-active);
   }
 </style>

package/dist/button/SplitButtonGroup.svelte.d.ts

@@ -1,33 +1,13 @@
 import type { Snippet } from 'svelte';
-import type { DropdownItem } from '../dropdown/types.js';
-import type { Placement } from '@chenzy-design/core';
-import type { ButtonType, ButtonTheme, ButtonSize } from './context.js';
 interface Props {
-    type?: ButtonType;
-    theme?: ButtonTheme;
-    size?: ButtonSize;
-    disabled?: boolean;
-    loading?: boolean;
-    /** 下拉菜单数据项（透传给 Dropdown.items）。 */
-    items?: DropdownItem[];
-    /** 下拉浮层位置（透传给 Dropdown.position）。 */
-    position?: Placement;
-    /** 下拉箭头按钮的 aria-label（无文字按钮必填）。 */
-    triggerAriaLabel?: string;
-    /** 选中下拉项回调。 */
-    onSelect?: (key: string | number) => void;
-    /** 主按钮点击回调。 */
-    onclick?: (e: MouseEvent) => void;
     /** 分裂按钮组语义标签（root aria-label，对齐 Semi）。 */
     ariaLabel?: string;
     /** 根元素自定义类名（透传）。 */
     class?: string;
     /** 根元素自定义内联样式（透传）。 */
     style?: string;
-    /** 左侧主按钮内容。 */
+    /** 分裂按钮内容（Button + Dropdown 等）。 */
     children?: Snippet;
-    /** 自定义下拉菜单体（替代 items）。 */
-    menu?: Snippet;
 }
 declare const SplitButtonGroup: import("svelte").Component<Props, {}, "">;
 type SplitButtonGroup = ReturnType<typeof SplitButtonGroup>;

package/dist/button/SplitButtonGroup.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SplitButtonGroup.svelte.d.ts","sourceRoot":"","sources":["../../src/button/SplitButtonGroup.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGtE,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe;IACf,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1C,eAAe;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA6DH,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"SplitButtonGroup.svelte.d.ts","sourceRoot":"","sources":["../../src/button/SplitButtonGroup.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGpC,UAAU,KAAK;IACb,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkDH,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/button/meta.d.ts

@@ -5,11 +5,11 @@
 export declare const meta: {
     readonly name: "Button";
     readonly category: "basic";
-    readonly description: "触发即时操作的按钮，最基础的交互原子。";
+    readonly description: "触发即时操作的按钮，最基础的交互原子（严格对齐 Semi Button）。";
     readonly props: readonly [{
         readonly name: "type";
         readonly type: "'primary'|'secondary'|'tertiary'|'warning'|'danger'";
-        readonly default: "secondary";
+        readonly default: "primary";
         readonly desc: "语义类型";
     }, {
         readonly name: "theme";
@@ -30,17 +30,22 @@ export declare const meta: {
         readonly name: "disabled";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "禁用状态";
+        readonly desc: "禁用状态（底灰 + 灰字，优先级高于 loading）";
     }, {
         readonly name: "loading";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "加载态（带 Spin，禁用点击）";
+        readonly desc: "加载态（带旋转图标，禁用点击）";
     }, {
         readonly name: "colorful";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "AI 多彩按钮：所有 theme 下品牌蓝→紫渐变；type 仅 primary/tertiary 有意义";
+        readonly desc: "AI 多彩按钮：type 仅 primary/tertiary 有意义（对齐 Semi）";
+    }, {
+        readonly name: "circle";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "圆形按钮（border-radius:50%），配合 icon-only 呈正圆";
     }, {
         readonly name: "htmlType";
         readonly type: "'button'|'submit'|'reset'";
@@ -60,12 +65,12 @@ export declare const meta: {
         readonly name: "noHorizontalPadding";
         readonly type: "boolean|'left'|'right'|('left'|'right')[]";
         readonly default: "false";
-        readonly desc: "仅设置 icon 时去单/双侧水平内距";
+        readonly desc: "仅设置 icon 时去单/双侧水平内距（inline padding）";
     }, {
         readonly name: "ariaLabel";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "无障碍名；纯图标按钮必填";
+        readonly desc: "无障碍名（透传 aria-label）；纯图标按钮必填";
     }, {
         readonly name: "class";
         readonly type: "string";
@@ -80,12 +85,17 @@ export declare const meta: {
         readonly name: "contentClassName";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "内容区自定义类名";
+        readonly desc: "内容区（.cd-button-content）自定义类名";
+    }, {
+        readonly name: "...rest";
+        readonly type: "HTMLButtonAttributes";
+        readonly default: "-";
+        readonly desc: "其余原生属性透传到根 button：data-*/name/value/form/title/tabindex/aria-controls/aria-expanded 等";
     }];
     readonly events: readonly [{
         readonly name: "onclick";
         readonly payload: "MouseEvent";
-        readonly desc: "disabled/loading 时不触发";
+        readonly desc: "disabled/loading 时不触发（原生 disabled 阻断）";
     }, {
         readonly name: "onmousedown";
         readonly payload: "MouseEvent";
@@ -109,7 +119,7 @@ export declare const meta: {
     readonly subComponents: readonly [{
         readonly name: "ButtonGroup";
         readonly usage: "<ButtonGroup> 包裹多个 <Button>，组级默认经 context 透传";
-        readonly desc: "横向拼接多个 Button；组级 size/type/theme/disabled/colorful 经 context 透传，组内 Button 显式 prop 始终优先。";
+        readonly desc: "横向拼接多个 Button；组级 size/type/theme/disabled/colorful 经 context 透传，组内 Button 显式 prop 始终优先。相邻按钮间以 1px 分隔条区隔（outline 主题走 border 叠边）。";
         readonly props: readonly [{
             readonly name: "type";
             readonly type: "'primary'|'secondary'|'tertiary'|'warning'|'danger'";
@@ -153,64 +163,9 @@ export declare const meta: {
         }];
     }, {
         readonly name: "SplitButtonGroup";
-        readonly usage: "<SplitButtonGroup items={...}>，左侧主操作 + 右侧箭头触发下拉";
-        readonly desc: "分裂按钮：左侧主 Button + 右侧箭头按钮，点击箭头弹出 Dropdown（复用 items API 或 menu snippet）。";
+        readonly usage: "<SplitButtonGroup> 包裹 Button + Dropdown(箭头 Button)，纯容器（对齐 Semi）";
+        readonly desc: "分裂按钮：纯 role=group 容器，为内部首/末 button 加圆角并添加按钮间隔。典型用法为左侧主 Button + 右侧 Dropdown 触发的箭头 Button。";
         readonly props: readonly [{
-            readonly name: "type";
-            readonly type: "'primary'|'secondary'|'tertiary'|'warning'|'danger'";
-            readonly default: "primary";
-            readonly desc: "两侧按钮语义类型";
-        }, {
-            readonly name: "theme";
-            readonly type: "'solid'|'borderless'|'light'|'outline'";
-            readonly default: "solid";
-            readonly desc: "两侧按钮视觉变体";
-        }, {
-            readonly name: "size";
-            readonly type: "'small'|'default'|'large'";
-            readonly default: "default";
-            readonly desc: "两侧按钮尺寸";
-        }, {
-            readonly name: "disabled";
-            readonly type: "boolean";
-            readonly default: "false";
-            readonly desc: "禁用整个分裂按钮";
-        }, {
-            readonly name: "loading";
-            readonly type: "boolean";
-            readonly default: "false";
-            readonly desc: "主按钮加载态";
-        }, {
-            readonly name: "items";
-            readonly type: "DropdownItem[]";
-            readonly default: "[]";
-            readonly desc: "下拉菜单数据项（透传给 Dropdown.items）";
-        }, {
-            readonly name: "position";
-            readonly type: "Placement";
-            readonly default: "bottomEnd";
-            readonly desc: "下拉浮层位置";
-        }, {
-            readonly name: "triggerAriaLabel";
-            readonly type: "string";
-            readonly default: "更多操作";
-            readonly desc: "下拉箭头按钮的 aria-label";
-        }, {
-            readonly name: "onSelect";
-            readonly type: "(key: string|number) => void";
-            readonly default: "undefined";
-            readonly desc: "选中下拉项回调";
-        }, {
-            readonly name: "onclick";
-            readonly type: "(e: MouseEvent) => void";
-            readonly default: "undefined";
-            readonly desc: "主按钮点击回调";
-        }, {
-            readonly name: "menu";
-            readonly type: "Snippet";
-            readonly default: "undefined";
-            readonly desc: "自定义下拉菜单体（替代 items）";
-        }, {
             readonly name: "ariaLabel";
             readonly type: "string";
             readonly default: "undefined";
@@ -225,13 +180,18 @@ export declare const meta: {
             readonly type: "string";
             readonly default: "undefined";
             readonly desc: "根元素自定义内联样式";
+        }, {
+            readonly name: "children";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "分裂按钮内容（Button + Dropdown 等）";
         }];
     }];
     readonly a11y: {
         readonly role: "button";
         readonly keyboard: readonly ["Enter", "Space"];
     };
-    readonly tokens: readonly ["--cd-button-*"];
+    readonly tokens: readonly ["--cd-color-button-*", "--cd-height-button-*", "--cd-width-button-*", "--cd-spacing-button-*", "--cd-radius-button", "--cd-radius-button-group", "--cd-radius-button-splitbuttongroup-*", "--cd-color-button-group-*", "--cd-width-button-group-border", "--cd-height-button-group-line-default", "--cd-font-button-*", "--cd-transition-*-button-*", "--cd-transform-scale-button-*", "--cd-animation-duration-button-icon-*", "--cd-color-ai-general*", "--cd-color-ai-purple"];
     readonly examples: readonly [{
         readonly title: "基础";
         readonly code: "<Button type=\"primary\">确定</Button>";

package/dist/button/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/button/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEP,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/button/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFP,CAAC"}