@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/tabs/Tabs.svelte.d.ts

@@ -1,47 +1,49 @@
 import type { Snippet } from 'svelte';
 import type { TabItem } from './types.js';
 type TabKey = string | number;
-type TabType = 'line' | 'card' | 'button';
-type TabSize = 'small' | 'default' | 'large';
-type TabPosition = 'top' | 'bottom' | 'left' | 'right';
-type KeyboardActivation = 'auto' | 'manual';
-type OverflowMode = 'scroll' | 'dropdown';
+type TabType = 'line' | 'card' | 'button' | 'slash';
+type TabSize = 'small' | 'medium' | 'large';
+type TabPosition = 'top' | 'left';
+/** collapsible：false 不折叠；true 强制折叠收纳；'auto' 自动检测溢出再决定是否折叠。 */
+type Collapsible = boolean | 'auto';
 type MoreConfig = number | {
     count?: number;
     render?: Snippet;
     dropdownProps?: Record<string, unknown>;
 };
+/** dropdownProps 折叠模式下透传下拉参数：start=前箭头下拉，end=后箭头/更多下拉（对齐 Semi）。 */
+interface DropdownPropsPair {
+    start?: Record<string, unknown>;
+    end?: Record<string, unknown>;
+}
 interface Props {
-    value?: TabKey;
-    defaultValue?: TabKey;
+    /** 受控选中标签 key（对齐 Semi activeKey）。 */
+    activeKey?: TabKey;
+    /** 非受控初始选中 key（对齐 Semi defaultActiveKey）。 */
+    defaultActiveKey?: TabKey;
+    /** 视觉风格：line 线条 / card 卡片 / button 分段按钮 / slash 斜线（slash 仅横向）。 */
     type?: TabType;
+    /** 尺寸档（对齐 Semi）：small / medium / large，默认 large。 */
     size?: TabSize;
+    /** 标签栏位置（对齐 Semi）：top 水平 / left 垂直。slash 仅支持 top。 */
     tabPosition?: TabPosition;
     tabList?: TabItem[];
     closable?: boolean;
-    keyboardActivation?: KeyboardActivation;
-    /**
-     * 横向溢出处理方式：
-     * - 'scroll'（默认）：标签超出容器时显示前/后滚动箭头，命令式滚动；
-     * - 'dropdown'：把放不下的标签收纳进末尾「更多」下拉，点下拉项跳到对应 tab。
-     * 仅 top/bottom 横向标签栏生效；纵向（left/right）始终走滚动。
-     */
-    overflow?: OverflowMode;
     /**
-     * line 风格横向溢出时启用折叠收纳（与 overflow='dropdown' 同效：放不下的标签进末尾「更多」下拉）。
-     * 便捷开关：为 true 时强制走 dropdown 收纳（仅 top/bottom 横向生效）。默认 false。
+     * 折叠收纳（对齐 Semi）：
+     * - false（默认）：不折叠；
+     * - true：溢出时显示前/后切换箭头，可滚动查看被裁切标签（仅横向 top 生效）；
+     * - 'auto'：自动检测——标签溢出容器时才启用折叠，容器变宽/标签变少能全显时自动退出。
      */
-    collapsible?: boolean;
-    /** 首次激活后才挂载面板内容 */
-    lazy?: boolean;
-    /** 激活过的面板切走后保留 DOM（display:none），而非卸载 */
+    collapsible?: Collapsible;
+    /** 懒渲染：仅当面板激活过才挂载进 DOM（对齐 Semi lazyRender） */
+    lazyRender?: boolean;
+    /** 使用 TabPane 写法时是否渲染隐藏面板的 DOM 结构（对齐 Semi keepDOM，默认 true） */
     keepDOM?: boolean;
-    /** 标签栏末尾显示「+」按钮，点击触发 onAdd（受控数据，由父组件追加） */
-    addable?: boolean;
     /**
-     * 溢出折叠配置：数字时等价于 { count: n }；对象时含 count（收起阈值）、
-     * render（自定义「更多」触发器 Snippet）、dropdownProps（透传下拉参数）。
-     * 仅 overflow='dropdown'（或 collapsible=true）时生效。
+     * 溢出折叠配置（对齐 Semi more）：把末尾若干标签收进「更多」下拉。
+     * 数字时等价于 { count: n }；对象时含 count（收起数量）、
+     * render（自定义「更多」触发器 Snippet）、dropdownProps（透传下拉参数）。仅横向生效。
      */
     more?: MoreConfig;
     /** 标签栏末尾「更多」下拉折叠时，折叠箭头位置（scroll 模式中的前/后箭头）。默认 'both'。 */
@@ -53,12 +55,21 @@ interface Props {
     }]>;
     /** dropdown 折叠模式是否在下拉中展示收起 tabs（默认 true） */
     showRestInDropdown?: boolean;
-    /** 透传给「更多」Dropdown 组件的 props */
-    dropdownProps?: Record<string, unknown>;
+    /** 折叠模式下透传下拉参数（对齐 Semi）：{ start, end }，分别作用于前箭头/后箭头「更多」下拉。 */
+    dropdownProps?: DropdownPropsPair;
     /** 溢出项变化回调，携带当前可见 tab keys */
     onVisibleTabsChange?: (visibleTabKeys: TabKey[]) => void;
     /** 内容区外层样式（string 或 CSSProperties 对象） */
     contentStyle?: string | Record<string, string>;
+    /** 标签栏（tab bar 容器 `.cd-tabs__bar`）自定义 class */
+    tabBarClassName?: string;
+    /** 标签栏（tab bar 容器 `.cd-tabs__bar`）自定义样式（string 或 CSSProperties 对象） */
+    tabBarStyle?: string | Record<string, string>;
+    /**
+     * 可见标签区域自定义样式（string 或 CSSProperties 对象）。
+     * scroll 模式作用于滚动视口 `.cd-tabs__nav`；dropdown 模式作用于可见标签容器 `.cd-tabs__list`。
+     */
+    visibleTabsStyle?: string | Record<string, string>;
     /** Tab 聚焦是否阻止页面滚动（默认 false） */
     preventScroll?: boolean;
     /** 面板切换是否启用动画（默认 true） */
@@ -68,16 +79,14 @@ interface Props {
     onChange?: (key: TabKey) => void;
     onTabClose?: (key: TabKey) => void;
     /**
-     * 标签被点击回调（spec §4：on:tabClick）。含已选中标签（未必触发 onChange），
+     * 标签被点击回调（对齐 Semi onTabClick）。含已选中标签（未必触发 onChange），
      * 在 disabled 拦截前发出，可用于埋点。
      */
     onTabClick?: (key: TabKey, event: MouseEvent) => void;
-    /** addable=true 时点击「+」按钮回调（红线 #1：组件内部不改 tabList） */
-    onAdd?: () => void;
     /**
      * 自定义整个标签栏的渲染（调用方完全自绘标签栏）。
      * 接收：当前 tab 列表（数据驱动 tabList 或声明式收集结果）、当前激活 key、
-     * 切换回调 setActive（受控时仅触发 onChange，不回写 value，红线 #1）。
+     * 切换回调 setActive（受控时仅触发 onChange，不回写 activeKey，红线 #1）。
      * 传入时跳过内置标签栏与溢出处理；面板内容仍按 activeKey 显隐。
      */
     renderTabBar?: Snippet<[TabItem[], TabKey | undefined, (key: TabKey) => void]>;

package/dist/tabs/Tabs.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.svelte.d.ts","sourceRoot":"","sources":["../../src/tabs/Tabs.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Tabs.svelte.d.ts","sourceRoot":"","sources":["../../src/tabs/Tabs.svelte.ts"],"names":[],"mappings":"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"}

package/dist/tabs/context.d.ts

@@ -1,7 +1,10 @@
+import { type Snippet } from 'svelte';
 /** 声明式 <Tabs.Pane> 向父 Tabs 注册时上报的标签元数据（推导 tabList 用）。 */
 export interface TabPaneRegistration {
     itemKey: string | number;
     tab: string;
+    /** 标签文字前的图标 Snippet（对齐 Semi PlainTab.icon）。 */
+    icon?: Snippet;
     disabled?: boolean;
     closable?: boolean;
 }

package/dist/tabs/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tabs/context.ts"],"names":[],"mappings":"AAIA,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,qBAAqB;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC3C,kDAAkD;IAClD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC7C;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,MAAM,CAAC;IACpD,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAErD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAExD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tabs/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAI9D,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,qBAAqB;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC3C,kDAAkD;IAClD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC7C;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,MAAM,CAAC;IACpD,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAErD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAExD"}

package/dist/tabs/meta.d.ts

@@ -5,96 +5,82 @@
 export declare const meta: {
     readonly name: "Tabs";
     readonly category: "navigation";
-    readonly description: "标签页，在同一区域内组织并切换多组对等内容。支持 line/card/button 类型、数据驱动 tabList 或纯声明式 <Tabs.Pane> 自动收集、renderTabBar 自定义标签栏、roving tabindex 键盘导航、可关闭标签与溢出滚动/下拉收纳（overflow）。";
+    readonly description: "标签页，在同一区域内组织并切换多组对等内容。全量对齐 Semi Design：支持 line/card/button/slash 类型、top/left 位置、small/medium/large 尺寸、数据驱动 tabList 或纯声明式 <Tabs.Pane> 自动收集、renderTabBar 自定义标签栏、roving tabindex 键盘导航、可关闭标签、more 收纳与 collapsible 滚动折叠（含 auto 自动检测）。";
     readonly props: readonly [{
-        readonly name: "value";
+        readonly name: "activeKey";
         readonly type: "string|number";
         readonly default: "undefined";
-        readonly desc: "受控选中标签 key";
+        readonly desc: "受控选中标签 key（对齐 Semi）";
     }, {
-        readonly name: "defaultValue";
+        readonly name: "defaultActiveKey";
         readonly type: "string|number";
         readonly default: "首个标签";
-        readonly desc: "非受控初始 key";
+        readonly desc: "非受控初始 key（对齐 Semi）";
     }, {
         readonly name: "type";
-        readonly type: "'line'|'card'|'button'";
+        readonly type: "'line'|'card'|'button'|'slash'";
         readonly default: "line";
-        readonly desc: "视觉风格（button=分段按钮组）";
+        readonly desc: "视觉风格（button=分段按钮组，slash=斜线式仅横向）";
     }, {
         readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
-        readonly default: "default";
+        readonly type: "'small'|'medium'|'large'";
+        readonly default: "large";
+        readonly desc: "尺寸档（对齐 Semi）";
     }, {
         readonly name: "tabPosition";
-        readonly type: "'top'|'bottom'|'left'|'right'";
+        readonly type: "'top'|'left'";
         readonly default: "top";
-        readonly desc: "标签栏位置";
+        readonly desc: "标签栏位置：top 水平 / left 垂直（对齐 Semi；slash 仅 top）";
     }, {
-        readonly name: "lazy";
+        readonly name: "lazyRender";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "首次激活后才挂载面板";
+        readonly desc: "懒渲染：仅当面板激活过才挂载进 DOM（对齐 Semi）";
     }, {
         readonly name: "keepDOM";
         readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "激活过的面板保留 DOM";
+        readonly default: "true";
+        readonly desc: "使用 TabPane 写法时是否渲染隐藏面板的 DOM（对齐 Semi）";
     }, {
         readonly name: "tabList";
         readonly type: "TabItem[]";
         readonly default: "undefined";
-        readonly desc: "数据驱动标签定义；不传则从子 <Tabs.Pane> 的 tab/itemKey/disabled/closable 纯声明式自动收集";
+        readonly desc: "数据驱动标签定义；不传则从子 <Tabs.Pane> 的 tab/itemKey/icon/disabled/closable 纯声明式自动收集。TabItem 支持 icon?: Snippet（标签文字前渲染的图标）";
     }, {
         readonly name: "closable";
         readonly type: "boolean";
         readonly default: "false";
         readonly desc: "全局可关闭（单项可覆盖）";
-    }, {
-        readonly name: "addable";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "标签栏末尾显示「+」按钮，点击触发 onAdd（受控，由父组件追加）";
-    }, {
-        readonly name: "keyboardActivation";
-        readonly type: "'auto'|'manual'";
-        readonly default: "auto";
-        readonly desc: "方向键聚焦即激活 / 需 Enter/Space 激活";
-    }, {
-        readonly name: "overflow";
-        readonly type: "'scroll'|'dropdown'";
-        readonly default: "scroll";
-        readonly desc: "横向溢出处理：scroll 前/后滚动箭头；dropdown 收纳进末尾「更多」下拉（仅 top/bottom 生效，纵向始终滚动）";
     }, {
         readonly name: "collapsible";
-        readonly type: "boolean";
+        readonly type: "boolean | 'auto'";
         readonly default: "false";
-        readonly desc: "line 风格横向溢出时启用折叠收纳（便捷开关，等价 overflow=dropdown：放不下的标签进末尾「更多」下拉，仅 top/bottom 生效）";
+        readonly desc: "滚动折叠（对齐 Semi）：true 溢出时显示前/后切换箭头；auto 自动检测溢出再决定是否折叠（仅横向生效）";
     }, {
         readonly name: "more";
         readonly type: "number | { count?: number; render?: Snippet; dropdownProps?: object }";
         readonly default: "undefined";
-        readonly desc: "溢出折叠配置：数字简写或对象形式，仅 dropdown 模式有效";
+        readonly desc: "把末尾若干标签收进「更多」下拉（对齐 Semi）：数字简写或对象形式（count/render/dropdownProps）";
     }, {
         readonly name: "arrowPosition";
         readonly type: "'start'|'end'|'both'";
         readonly default: "both";
-        readonly desc: "scroll 模式中前/后箭头位置";
+        readonly desc: "collapsible 折叠模式中前/后切换箭头位置";
     }, {
         readonly name: "renderArrow";
         readonly type: "Snippet<[{ type: 'start'|'end'; onClick: () => void }]>";
         readonly default: "undefined";
-        readonly desc: "自定义前/后滚动箭头";
+        readonly desc: "collapsible 折叠模式下自定义前/后切换箭头";
     }, {
         readonly name: "showRestInDropdown";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "dropdown 折叠模式是否在下拉中展示收起 tabs";
+        readonly desc: "more 收纳模式是否在下拉中展示收起 tabs";
     }, {
         readonly name: "dropdownProps";
-        readonly type: "object";
+        readonly type: "{ start?: object; end?: object }";
         readonly default: "undefined";
-        readonly desc: "透传给「更多」Dropdown 组件的 props";
+        readonly desc: "折叠模式下透传下拉参数（对齐 Semi）：start=前箭头下拉，end=末尾「更多」下拉";
     }, {
         readonly name: "onVisibleTabsChange";
         readonly type: "(visibleTabKeys: (string|number)[]) => void";
@@ -120,6 +106,21 @@ export declare const meta: {
         readonly type: "Snippet";
         readonly default: "undefined";
         readonly desc: "标签栏右侧额外内容";
+    }, {
+        readonly name: "tabBarClassName";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "标签栏容器（.cd-tabs__bar）自定义 class";
+    }, {
+        readonly name: "tabBarStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "标签栏容器（.cd-tabs__bar）自定义样式";
+    }, {
+        readonly name: "visibleTabsStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "可见标签区域自定义样式（scroll 模式作用于 .cd-tabs__nav，dropdown 模式作用于 .cd-tabs__list）";
     }, {
         readonly name: "onChange";
         readonly type: "(key: string|number) => void";
@@ -133,11 +134,6 @@ export declare const meta: {
         readonly type: "(key: string|number, event: MouseEvent) => void";
         readonly default: "undefined";
         readonly desc: "标签被点击触发（含已选中标签，未必触发 onChange；disabled 拦截前发出，可用于埋点）";
-    }, {
-        readonly name: "onAdd";
-        readonly type: "() => void";
-        readonly default: "undefined";
-        readonly desc: "addable=true 时点击「+」按钮回调（受控数据，组件内不改 tabList）";
     }, {
         readonly name: "renderTabBar";
         readonly type: "Snippet<[TabItem[], string|number|undefined, (key) => void]>";
@@ -147,13 +143,13 @@ export declare const meta: {
         readonly name: "children";
         readonly type: "Snippet";
         readonly default: "undefined";
-        readonly desc: "声明式 TabPane 内容（<Tabs.Pane>）";
+        readonly desc: "声明式 TabPane 内容（<Tabs.Pane>），<Tabs.Pane> 支持 icon?: Snippet（标签文字前渲染的图标）";
     }];
     readonly a11y: {
         readonly role: "tablist";
         readonly keyboard: readonly ["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Home", "End", "Enter", "Space"];
-        readonly notes: readonly ["tablist 内每个标签为 role=tab，aria-selected 标记激活，aria-controls 关联面板", "roving tabindex：仅激活标签 tabindex=0，其余 -1", "keyboardActivation=auto 聚焦即激活，manual 需 Enter/Space 确认", "面板 role=tabpanel；关闭叉为带 aria-label 的原生 button", "标签溢出时出现前/后滚动箭头（带 aria-label，tabindex=-1 不入 Tab 序），激活标签自动滚到可视区", "overflow=dropdown 时溢出标签收进末尾「更多」下拉（aria-haspopup=menu，带 aria-label），激活标签始终保持可见", "addable 的「+」为带 aria-label 的原生 button", "renderTabBar 自定义标签栏时由调用方负责无障碍语义（role=tab/aria-selected 等）", "preventScroll=true 时 Tab 聚焦不触发页面滚动"];
+        readonly notes: readonly ["tablist 内每个标签为 role=tab，aria-selected 标记激活，aria-controls 关联面板", "roving tabindex：仅激活标签 tabindex=0，其余 -1", "对齐 Semi 手动激活：方向键仅移动焦点，Enter/Space 或点击才激活对应面板", "面板 role=tabpanel；关闭叉为带 aria-label 的原生 button", "标签溢出时出现前/后滚动箭头（带 aria-label，tabindex=-1 不入 Tab 序），激活标签自动滚到可视区", "more 收纳时溢出标签收进末尾「更多」下拉（aria-haspopup=menu，带 aria-label），激活标签始终保持可见", "renderTabBar 自定义标签栏时由调用方负责无障碍语义（role=tab/aria-selected 等）", "preventScroll=true 时 Tab 聚焦不触发页面滚动"];
     };
-    readonly tokens: readonly ["--cd-tabs-*", "--cd-focus-ring", "--cd-border-radius-small", "--cd-spacing-*"];
+    readonly tokens: readonly ["--cd-color-tabs-tab-line-border-default", "--cd-color-tabs-tab-line-border-hover", "--cd-color-tabs-tab-line-border-active", "--cd-color-tabs-tab-line-text-default", "--cd-color-tabs-tab-line-text-hover", "--cd-color-tabs-tab-line-text-active", "--cd-color-tabs-tab-line-selected-text-default", "--cd-color-tabs-tab-line-selected-indicator-default", "--cd-color-tabs-tab-line-vertical-selected-bg-default", "--cd-color-tabs-tab-line-vertical-bg-hover", "--cd-color-tabs-tab-line-vertical-bg-active", "--cd-color-tabs-tab-line-disabled-text-default", "--cd-color-tabs-tab-card-border-default", "--cd-color-tabs-tab-card-selected-indicator-default", "--cd-color-tabs-tab-card-bg-hover", "--cd-color-tabs-tab-card-bg-active", "--cd-color-tabs-tab-card-selected-bg-default", "--cd-color-tabs-tab-button-text-default", "--cd-color-tabs-tab-button-bg-hover", "--cd-color-tabs-tab-button-bg-active", "--cd-color-tabs-tab-button-selected-bg-default", "--cd-color-tabs-tab-button-selected-text-default", "--cd-color-tabs-tab-icon-default", "--cd-color-tabs-tab-icon-hover", "--cd-color-tabs-tab-icon-active", "--cd-color-tabs-tab-selected-icon-default", "--cd-color-tabs-tab-pane-text-default", "--cd-color-tabs-tab-slash-line", "--cd-color-tabs-tab-pane-arrow-text-default", "--cd-color-tabs-tab-pane-arrow-bg-hover", "--cd-color-tabs-tab-pane-arrow-bg-active", "--cd-color-tabs-tab-pane-arrow-disabled-text-default", "--cd-font-tabs-tab-fontweight", "--cd-font-tabs-tab-active-fontweight", "--cd-font-tabs-tab-fontsize", "--cd-width-tabs-bar-line-border", "--cd-width-tabs-bar-line-tab-border", "--cd-width-tabs-bar-card-border", "--cd-width-tabs-tab-slash-line", "--cd-height-tabs-tab-slash-line", "--cd-spacing-tabs-tab-icon-marginright", "--cd-spacing-tabs-tab-pane-arrow", "--cd-spacing-tabs-overflow-icon-marginleft", "--cd-spacing-tabs-overflow-icon-marginright", "--cd-spacing-tabs-bar-extra-paddingx", "--cd-spacing-tabs-bar-extra-paddingy", "--cd-spacing-tabs-bar-line-tab-paddingtop", "--cd-spacing-tabs-bar-line-tab-paddingx", "--cd-spacing-tabs-bar-line-tab-paddingbottom", "--cd-spacing-tabs-bar-line-tab-marginright", "--cd-spacing-tabs-bar-line-tab-small-paddingtop", "--cd-spacing-tabs-bar-line-tab-small-paddingbottom", "--cd-spacing-tabs-bar-line-tab-medium-paddingtop", "--cd-spacing-tabs-bar-line-tab-medium-paddingbottom", "--cd-spacing-tabs-bar-line-tab-left-padding", "--cd-spacing-tabs-bar-line-tab-left-small-padding", "--cd-spacing-tabs-bar-line-tab-left-medium-padding", "--cd-spacing-tabs-bar-slash-tab-paddingy", "--cd-spacing-tabs-bar-slash-tab-paddingx", "--cd-spacing-tabs-bar-slash-marginright", "--cd-spacing-tabs-bar-slash-line-marginleft", "--cd-spacing-tabs-bar-slash-line-marginy", "--cd-spacing-tabs-content-paddingy", "--cd-spacing-tabs-content-paddingx", "--cd-spacing-tabs-content-left-paddingx", "--cd-spacing-tabs-bar-card-tab-marginright", "--cd-spacing-tabs-bar-card-tab-paddingy", "--cd-spacing-tabs-bar-card-tab-paddingx", "--cd-spacing-tabs-bar-card-tab-active-paddingbottom", "--cd-spacing-tabs-bar-card-tab-left-marginbottom", "--cd-spacing-tabs-bar-button-tab-marginright", "--cd-spacing-tabs-bar-button-tab-marginbottom", "--cd-spacing-tabs-bar-button-tab-paddingy", "--cd-spacing-tabs-bar-button-tab-paddingx", "--cd-radius-tabs-tab-card", "--cd-radius-tabs-tab-card-left", "--cd-radius-tabs-tab-button", "--cd-focus-ring", "--cd-border-radius-small"];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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

package/dist/tabs/meta.js

@@ -5,80 +5,62 @@
 export const meta = {
     name: 'Tabs',
     category: 'navigation',
-    description: '标签页，在同一区域内组织并切换多组对等内容。支持 line/card/button 类型、数据驱动 tabList 或纯声明式 <Tabs.Pane> 自动收集、renderTabBar 自定义标签栏、roving tabindex 键盘导航、可关闭标签与溢出滚动/下拉收纳（overflow）。',
+    description: '标签页，在同一区域内组织并切换多组对等内容。全量对齐 Semi Design：支持 line/card/button/slash 类型、top/left 位置、small/medium/large 尺寸、数据驱动 tabList 或纯声明式 <Tabs.Pane> 自动收集、renderTabBar 自定义标签栏、roving tabindex 键盘导航、可关闭标签、more 收纳与 collapsible 滚动折叠（含 auto 自动检测）。',
     props: [
-        { name: 'value', type: 'string|number', default: 'undefined', desc: '受控选中标签 key' },
-        { name: 'defaultValue', type: 'string|number', default: '首个标签', desc: '非受控初始 key' },
-        { name: 'type', type: "'line'|'card'|'button'", default: 'line', desc: '视觉风格（button=分段按钮组）' },
-        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        { name: 'activeKey', type: 'string|number', default: 'undefined', desc: '受控选中标签 key（对齐 Semi）' },
+        { name: 'defaultActiveKey', type: 'string|number', default: '首个标签', desc: '非受控初始 key（对齐 Semi）' },
+        { name: 'type', type: "'line'|'card'|'button'|'slash'", default: 'line', desc: '视觉风格（button=分段按钮组，slash=斜线式仅横向）' },
+        { name: 'size', type: "'small'|'medium'|'large'", default: 'large', desc: '尺寸档（对齐 Semi）' },
         {
             name: 'tabPosition',
-            type: "'top'|'bottom'|'left'|'right'",
+            type: "'top'|'left'",
             default: 'top',
-            desc: '标签栏位置',
+            desc: '标签栏位置：top 水平 / left 垂直（对齐 Semi；slash 仅 top）',
         },
-        { name: 'lazy', type: 'boolean', default: 'false', desc: '首次激活后才挂载面板' },
-        { name: 'keepDOM', type: 'boolean', default: 'false', desc: '激活过的面板保留 DOM' },
+        { name: 'lazyRender', type: 'boolean', default: 'false', desc: '懒渲染：仅当面板激活过才挂载进 DOM（对齐 Semi）' },
+        { name: 'keepDOM', type: 'boolean', default: 'true', desc: '使用 TabPane 写法时是否渲染隐藏面板的 DOM（对齐 Semi）' },
         {
             name: 'tabList',
             type: 'TabItem[]',
             default: 'undefined',
-            desc: '数据驱动标签定义；不传则从子 <Tabs.Pane> 的 tab/itemKey/disabled/closable 纯声明式自动收集',
+            desc: '数据驱动标签定义；不传则从子 <Tabs.Pane> 的 tab/itemKey/icon/disabled/closable 纯声明式自动收集。TabItem 支持 icon?: Snippet（标签文字前渲染的图标）',
         },
         { name: 'closable', type: 'boolean', default: 'false', desc: '全局可关闭（单项可覆盖）' },
-        {
-            name: 'addable',
-            type: 'boolean',
-            default: 'false',
-            desc: '标签栏末尾显示「+」按钮，点击触发 onAdd（受控，由父组件追加）',
-        },
-        {
-            name: 'keyboardActivation',
-            type: "'auto'|'manual'",
-            default: 'auto',
-            desc: '方向键聚焦即激活 / 需 Enter/Space 激活',
-        },
-        {
-            name: 'overflow',
-            type: "'scroll'|'dropdown'",
-            default: 'scroll',
-            desc: '横向溢出处理：scroll 前/后滚动箭头；dropdown 收纳进末尾「更多」下拉（仅 top/bottom 生效，纵向始终滚动）',
-        },
         {
             name: 'collapsible',
-            type: 'boolean',
+            type: "boolean | 'auto'",
             default: 'false',
-            desc: 'line 风格横向溢出时启用折叠收纳（便捷开关，等价 overflow=dropdown：放不下的标签进末尾「更多」下拉，仅 top/bottom 生效）',
+            desc: '滚动折叠（对齐 Semi）：true 溢出时显示前/后切换箭头；auto 自动检测溢出再决定是否折叠（仅横向生效）',
         },
         {
             name: 'more',
             type: "number | { count?: number; render?: Snippet; dropdownProps?: object }",
             default: 'undefined',
-            desc: '溢出折叠配置：数字简写或对象形式，仅 dropdown 模式有效',
+            desc: '把末尾若干标签收进「更多」下拉（对齐 Semi）：数字简写或对象形式（count/render/dropdownProps）',
         },
         {
             name: 'arrowPosition',
             type: "'start'|'end'|'both'",
             default: 'both',
-            desc: 'scroll 模式中前/后箭头位置',
+            desc: 'collapsible 折叠模式中前/后切换箭头位置',
         },
         {
             name: 'renderArrow',
             type: "Snippet<[{ type: 'start'|'end'; onClick: () => void }]>",
             default: 'undefined',
-            desc: '自定义前/后滚动箭头',
+            desc: 'collapsible 折叠模式下自定义前/后切换箭头',
         },
         {
             name: 'showRestInDropdown',
             type: 'boolean',
             default: 'true',
-            desc: 'dropdown 折叠模式是否在下拉中展示收起 tabs',
+            desc: 'more 收纳模式是否在下拉中展示收起 tabs',
         },
         {
             name: 'dropdownProps',
-            type: 'object',
+            type: '{ start?: object; end?: object }',
             default: 'undefined',
-            desc: '透传给「更多」Dropdown 组件的 props',
+            desc: '折叠模式下透传下拉参数（对齐 Semi）：start=前箭头下拉，end=末尾「更多」下拉',
         },
         {
             name: 'onVisibleTabsChange',
@@ -110,6 +92,24 @@ export const meta = {
             default: 'undefined',
             desc: '标签栏右侧额外内容',
         },
+        {
+            name: 'tabBarClassName',
+            type: 'string',
+            default: 'undefined',
+            desc: '标签栏容器（.cd-tabs__bar）自定义 class',
+        },
+        {
+            name: 'tabBarStyle',
+            type: 'string | Record<string, string>',
+            default: 'undefined',
+            desc: '标签栏容器（.cd-tabs__bar）自定义样式',
+        },
+        {
+            name: 'visibleTabsStyle',
+            type: 'string | Record<string, string>',
+            default: 'undefined',
+            desc: '可见标签区域自定义样式（scroll 模式作用于 .cd-tabs__nav，dropdown 模式作用于 .cd-tabs__list）',
+        },
         { name: 'onChange', type: '(key: string|number) => void', default: 'undefined' },
         { name: 'onTabClose', type: '(key: string|number) => void', default: 'undefined' },
         {
@@ -118,19 +118,13 @@ export const meta = {
             default: 'undefined',
             desc: '标签被点击触发（含已选中标签，未必触发 onChange；disabled 拦截前发出，可用于埋点）',
         },
-        {
-            name: 'onAdd',
-            type: '() => void',
-            default: 'undefined',
-            desc: 'addable=true 时点击「+」按钮回调（受控数据，组件内不改 tabList）',
-        },
         {
             name: 'renderTabBar',
             type: 'Snippet<[TabItem[], string|number|undefined, (key) => void]>',
             default: 'undefined',
             desc: '自定义整个标签栏渲染（接收 tab 列表、当前激活 key、切换回调 setActive）；传入时跳过内置标签栏与溢出处理，面板内容仍按 activeKey 显隐',
         },
-        { name: 'children', type: 'Snippet', default: 'undefined', desc: '声明式 TabPane 内容（<Tabs.Pane>）' },
+        { name: 'children', type: 'Snippet', default: 'undefined', desc: '声明式 TabPane 内容（<Tabs.Pane>），<Tabs.Pane> 支持 icon?: Snippet（标签文字前渲染的图标）' },
     ],
     a11y: {
         role: 'tablist',
@@ -138,14 +132,49 @@ export const meta = {
         notes: [
             'tablist 内每个标签为 role=tab，aria-selected 标记激活，aria-controls 关联面板',
             'roving tabindex：仅激活标签 tabindex=0，其余 -1',
-            'keyboardActivation=auto 聚焦即激活，manual 需 Enter/Space 确认',
+            '对齐 Semi 手动激活：方向键仅移动焦点，Enter/Space 或点击才激活对应面板',
             '面板 role=tabpanel；关闭叉为带 aria-label 的原生 button',
             '标签溢出时出现前/后滚动箭头（带 aria-label，tabindex=-1 不入 Tab 序），激活标签自动滚到可视区',
-            'overflow=dropdown 时溢出标签收进末尾「更多」下拉（aria-haspopup=menu，带 aria-label），激活标签始终保持可见',
-            'addable 的「+」为带 aria-label 的原生 button',
+            'more 收纳时溢出标签收进末尾「更多」下拉（aria-haspopup=menu，带 aria-label），激活标签始终保持可见',
             'renderTabBar 自定义标签栏时由调用方负责无障碍语义（role=tab/aria-selected 等）',
             'preventScroll=true 时 Tab 聚焦不触发页面滚动',
         ],
     },
-    tokens: ['--cd-tabs-*', '--cd-focus-ring', '--cd-border-radius-small', '--cd-spacing-*'],
+    // 组件实际消费的 token（名值一一对齐 Semi tabs/variables.scss；见 tokens/src/components/tabs.ts）。
+    tokens: [
+        // —— 颜色 ——
+        '--cd-color-tabs-tab-line-border-default', '--cd-color-tabs-tab-line-border-hover', '--cd-color-tabs-tab-line-border-active',
+        '--cd-color-tabs-tab-line-text-default', '--cd-color-tabs-tab-line-text-hover', '--cd-color-tabs-tab-line-text-active',
+        '--cd-color-tabs-tab-line-selected-text-default', '--cd-color-tabs-tab-line-selected-indicator-default',
+        '--cd-color-tabs-tab-line-vertical-selected-bg-default', '--cd-color-tabs-tab-line-vertical-bg-hover', '--cd-color-tabs-tab-line-vertical-bg-active',
+        '--cd-color-tabs-tab-line-disabled-text-default',
+        '--cd-color-tabs-tab-card-border-default', '--cd-color-tabs-tab-card-selected-indicator-default',
+        '--cd-color-tabs-tab-card-bg-hover', '--cd-color-tabs-tab-card-bg-active', '--cd-color-tabs-tab-card-selected-bg-default',
+        '--cd-color-tabs-tab-button-text-default', '--cd-color-tabs-tab-button-bg-hover', '--cd-color-tabs-tab-button-bg-active',
+        '--cd-color-tabs-tab-button-selected-bg-default', '--cd-color-tabs-tab-button-selected-text-default',
+        '--cd-color-tabs-tab-icon-default', '--cd-color-tabs-tab-icon-hover', '--cd-color-tabs-tab-icon-active', '--cd-color-tabs-tab-selected-icon-default',
+        '--cd-color-tabs-tab-pane-text-default', '--cd-color-tabs-tab-slash-line',
+        '--cd-color-tabs-tab-pane-arrow-text-default', '--cd-color-tabs-tab-pane-arrow-bg-hover', '--cd-color-tabs-tab-pane-arrow-bg-active', '--cd-color-tabs-tab-pane-arrow-disabled-text-default',
+        // —— 字重 / 字号 ——
+        '--cd-font-tabs-tab-fontweight', '--cd-font-tabs-tab-active-fontweight', '--cd-font-tabs-tab-fontsize',
+        // —— 线宽 / 斜线尺寸 ——
+        '--cd-width-tabs-bar-line-border', '--cd-width-tabs-bar-line-tab-border', '--cd-width-tabs-bar-card-border',
+        '--cd-width-tabs-tab-slash-line', '--cd-height-tabs-tab-slash-line',
+        // —— 间距（图标 / 箭头 / 附加 / 各类型内外边距 / 内容区）——
+        '--cd-spacing-tabs-tab-icon-marginright', '--cd-spacing-tabs-tab-pane-arrow',
+        '--cd-spacing-tabs-overflow-icon-marginleft', '--cd-spacing-tabs-overflow-icon-marginright',
+        '--cd-spacing-tabs-bar-extra-paddingx', '--cd-spacing-tabs-bar-extra-paddingy',
+        '--cd-spacing-tabs-bar-line-tab-paddingtop', '--cd-spacing-tabs-bar-line-tab-paddingx', '--cd-spacing-tabs-bar-line-tab-paddingbottom', '--cd-spacing-tabs-bar-line-tab-marginright',
+        '--cd-spacing-tabs-bar-line-tab-small-paddingtop', '--cd-spacing-tabs-bar-line-tab-small-paddingbottom',
+        '--cd-spacing-tabs-bar-line-tab-medium-paddingtop', '--cd-spacing-tabs-bar-line-tab-medium-paddingbottom',
+        '--cd-spacing-tabs-bar-line-tab-left-padding', '--cd-spacing-tabs-bar-line-tab-left-small-padding', '--cd-spacing-tabs-bar-line-tab-left-medium-padding',
+        '--cd-spacing-tabs-bar-slash-tab-paddingy', '--cd-spacing-tabs-bar-slash-tab-paddingx', '--cd-spacing-tabs-bar-slash-marginright', '--cd-spacing-tabs-bar-slash-line-marginleft', '--cd-spacing-tabs-bar-slash-line-marginy',
+        '--cd-spacing-tabs-content-paddingy', '--cd-spacing-tabs-content-paddingx', '--cd-spacing-tabs-content-left-paddingx',
+        '--cd-spacing-tabs-bar-card-tab-marginright', '--cd-spacing-tabs-bar-card-tab-paddingy', '--cd-spacing-tabs-bar-card-tab-paddingx', '--cd-spacing-tabs-bar-card-tab-active-paddingbottom', '--cd-spacing-tabs-bar-card-tab-left-marginbottom',
+        '--cd-spacing-tabs-bar-button-tab-marginright', '--cd-spacing-tabs-bar-button-tab-marginbottom', '--cd-spacing-tabs-bar-button-tab-paddingy', '--cd-spacing-tabs-bar-button-tab-paddingx',
+        // —— 圆角 ——
+        '--cd-radius-tabs-tab-card', '--cd-radius-tabs-tab-card-left', '--cd-radius-tabs-tab-button',
+        // —— 全局别名 ——
+        '--cd-focus-ring', '--cd-border-radius-small',
+    ],
 };

package/dist/tabs/types.d.ts

@@ -1,6 +1,9 @@
+import type { Snippet } from 'svelte';
 export interface TabItem {
     tab: string;
     itemKey: string | number;
+    /** 标签文字前渲染的图标（对齐 Semi PlainTab.icon）。 */
+    icon?: Snippet;
     disabled?: boolean;
     closable?: boolean;
 }

package/dist/tabs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,yCAAyC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/tag/SplitTagGroup.svelte

@@ -0,0 +1,62 @@
+<!--
+  SplitTagGroup — 严格对齐 Semi semi-ui/tag/splitTagGroup.tsx + tag.scss .semi-tag-split。
+  连接式标签组：多个 Tag 连成一体（首子前缘圆角、末子后缘圆角、中间去圆角，相邻 1px 间隙）。
+  Semi 通过 cloneElement 注入 first/last class；此处用纯 CSS :first-child/:last-child 定位直接子 .cd-tag，
+  语义等价且无运行时开销。circle 形状子标签首末用 radius-tag_circle。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  interface Props {
+    /** 组的可访问名（对齐 Semi aria-label） */
+    ariaLabel?: string;
+    /** 透传根类名（对齐 Semi className） */
+    class?: string;
+    /** 透传根内联样式（对齐 Semi style） */
+    style?: string;
+    /** 子 Tag（对齐 Semi children） */
+    children?: Snippet;
+  }
+
+  let { ariaLabel, class: className, style, children }: Props = $props();
+
+  const rootCls = $derived(['cd-tag-split', className].filter(Boolean).join(' '));
+</script>
+
+<div class={rootCls} {style} role="group" aria-label={ariaLabel}>
+  {#if children}{@render children()}{/if}
+</div>
+
+<style>
+  /* —— 对齐 Semi .semi-tag-split —— */
+  .cd-tag-split {
+    display: inline-flex;
+    align-items: center;
+  }
+
+  /* 子标签去圆角 + 相邻 1px 间隙（对齐 Semi .semi-tag-split .semi-tag）—— */
+  .cd-tag-split :global(> .cd-tag) {
+    border-radius: 0;
+    margin-right: var(--cd-tag-split-gap);
+  }
+  /* 首子前缘圆角（对齐 Semi &-first）—— */
+  .cd-tag-split :global(> .cd-tag:first-child) {
+    border-top-left-radius: var(--cd-tag-radius);
+    border-bottom-left-radius: var(--cd-tag-radius);
+  }
+  /* 末子后缘圆角 + 去右间隙（对齐 Semi &-last）—— */
+  .cd-tag-split :global(> .cd-tag:last-child) {
+    border-top-right-radius: var(--cd-tag-radius);
+    border-bottom-right-radius: var(--cd-tag-radius);
+    margin-right: 0;
+  }
+  /* circle 子标签首末用胶囊圆角（对齐 Semi &-circle.&-first/&-last）—— */
+  .cd-tag-split :global(> .cd-tag--circle:first-child) {
+    border-top-left-radius: var(--cd-tag-radius-circle);
+    border-bottom-left-radius: var(--cd-tag-radius-circle);
+  }
+  .cd-tag-split :global(> .cd-tag--circle:last-child) {
+    border-top-right-radius: var(--cd-tag-radius-circle);
+    border-bottom-right-radius: var(--cd-tag-radius-circle);
+  }
+</style>