straw-ui-vue 0.1.64 → 0.2.1

package/dist/components/st-button/base.d.ts

@@ -89,7 +89,7 @@ export declare const colorVariantCompoundVariants: readonly [{
         readonly color: "default";
         readonly variant: "ghost";
     };
-    readonly className: "text-secondary-foreground";
+    readonly className: "text-neutral-foreground";
 }, {
     readonly variants: {
         readonly color: "success";
@@ -125,7 +125,7 @@ export declare const groupMap: {
 /**
  * 桌面端 hover 态复合变体（color × variant 两个独立轴的配合；disabled 显式门控，禁用态不产出 hover 类）
  * - solid：在原填充色上加深
- * - ghost：叠加对应语义的半透明底色，default 走中性 accent
+ * - ghost：叠加对应语义的淡底，default 走中性淡底
  * 类名需保持字面量，供 UnoCSS 静态扫描收集
  * */
 export declare const hoverCompoundVariants: readonly [{
@@ -134,70 +134,70 @@ export declare const hoverCompoundVariants: readonly [{
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-primary/90";
+    readonly className: "hover:bg-primary-hover";
 }, {
     readonly variants: {
         readonly color: "default";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-secondary/80";
+    readonly className: "hover:bg-neutral-hover";
 }, {
     readonly variants: {
         readonly color: "success";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-success/90";
+    readonly className: "hover:bg-success-hover";
 }, {
     readonly variants: {
         readonly color: "warning";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-warning/90";
+    readonly className: "hover:bg-warning-hover";
 }, {
     readonly variants: {
         readonly color: "danger";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-danger/90";
+    readonly className: "hover:bg-danger-hover";
 }, {
     readonly variants: {
         readonly color: "primary";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-primary/10";
+    readonly className: "hover:bg-primary-subtle-hover";
 }, {
     readonly variants: {
         readonly color: "default";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-accent";
+    readonly className: "hover:bg-neutral-subtle";
 }, {
     readonly variants: {
         readonly color: "success";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-success/10";
+    readonly className: "hover:bg-success-subtle-hover";
 }, {
     readonly variants: {
         readonly color: "warning";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-warning/10";
+    readonly className: "hover:bg-warning-subtle-hover";
 }, {
     readonly variants: {
         readonly color: "danger";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "hover:bg-danger/10";
+    readonly className: "hover:bg-danger-subtle-hover";
 }];
 /** 移动端按压态复合变体（active：门控与配色规则同 hoverCompoundVariants） */
 export declare const activeCompoundVariants: readonly [{
@@ -206,68 +206,68 @@ export declare const activeCompoundVariants: readonly [{
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "active:bg-primary/90";
+    readonly className: "active:bg-primary-active";
 }, {
     readonly variants: {
         readonly color: "default";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "active:bg-secondary/80";
+    readonly className: "active:bg-neutral-active";
 }, {
     readonly variants: {
         readonly color: "success";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "active:bg-success/90";
+    readonly className: "active:bg-success-active";
 }, {
     readonly variants: {
         readonly color: "warning";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "active:bg-warning/90";
+    readonly className: "active:bg-warning-active";
 }, {
     readonly variants: {
         readonly color: "danger";
         readonly variant: "solid";
         readonly disabled: false;
     };
-    readonly className: "active:bg-danger/90";
+    readonly className: "active:bg-danger-active";
 }, {
     readonly variants: {
         readonly color: "primary";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "active:bg-primary/10";
+    readonly className: "active:bg-primary-subtle-active";
 }, {
     readonly variants: {
         readonly color: "default";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "active:bg-accent";
+    readonly className: "active:bg-neutral-subtle-hover";
 }, {
     readonly variants: {
         readonly color: "success";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "active:bg-success/10";
+    readonly className: "active:bg-success-subtle-active";
 }, {
     readonly variants: {
         readonly color: "warning";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "active:bg-warning/10";
+    readonly className: "active:bg-warning-subtle-active";
 }, {
     readonly variants: {
         readonly color: "danger";
         readonly variant: "ghost";
         readonly disabled: false;
     };
-    readonly className: "active:bg-danger/10";
+    readonly className: "active:bg-danger-subtle-active";
 }];

package/dist/components/st-date-picker/picker-classes.d.ts

@@ -1,5 +1,5 @@
 /** 焦点可见环，向外 2px 品牌描边，与全线浮层控件一致 */
-export declare const pickerFocusRing = "outline-none focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-primary";
+export declare const pickerFocusRing = "outline-none focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-primary-ring";
 /**
  * 面板内容容器
  * 边框 / 底色 / 圆角 / 投影由 StPopover 与 StDrawer 提供，此处只定宽与裁剪，避免二次描边
@@ -30,13 +30,13 @@ export declare const pickerTitleVariants: import('../../types').CVAReturnFunctio
 /** 底部工具条容器 */
 export declare const pickerFooterClasses = "flex items-center gap-default border-t border-border px-3 py-2 text-3.25";
 /** 底部文字按钮（清除 / 今天 / 此刻） */
-export declare const pickerLinkClasses = "shrink-0 cursor-pointer select-none rounded-md px-1.5 py-0.5 text-3.25 text-muted-foreground transition-colors duration-100 hover:bg-accent hover:text-foreground outline-none focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-primary";
+export declare const pickerLinkClasses = "shrink-0 cursor-pointer select-none rounded-md px-1.5 py-0.5 text-3.25 text-muted-foreground transition-colors duration-100 hover:bg-neutral-subtle hover:text-foreground outline-none focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-primary-ring";
 /** 次级说明文本 */
 export declare const pickerHintClasses = "min-w-0 flex-1 truncate text-3 text-muted-foreground tabular-nums";
 /** 列头 / 星期表头文本 */
 export declare const pickerLabelClasses = "text-center text-3 text-muted-foreground tabular-nums select-none";
 /** 端点步骤提示胶囊 */
-export declare const pickerChipClasses = "inline-flex h-5.5 shrink-0 items-center rounded-full bg-primary/10 px-2 text-2.75 font-medium text-primary tabular-nums";
+export declare const pickerChipClasses = "inline-flex h-5.5 shrink-0 items-center rounded-full bg-primary-subtle px-2 text-2.75 font-medium text-primary tabular-nums";
 /** 区间分隔竖线 */
 export declare const pickerDividerClasses = "w-px shrink-0 self-stretch bg-border";
 /** 日期时间双开关输入行 */

package/dist/components/st-message/base.d.ts

@@ -1,4 +1,5 @@
 import { StSize } from '../../types/size.d.ts';
+import { StMessageType } from './types/index.d.ts';
 /**
  * 消息组件的样式与常量表
  *
@@ -23,7 +24,14 @@ export declare const STACK_ANCHOR_KEY = "st-message-stack-anchor";
  * 条间距由容器的 gap 负责；离场项在动画开始时就 absolute 脱流，位置交给 move 动画搬，
  * 因此不需要收合行高，也不会有裁剪层切掉投影的问题。
  */
-export declare const messageItemBase = "pointer-events-auto flex items-center gap-default rounded bg-background border border-solid border-border shadow-md px-xl py-default max-w-[calc(100vw-2rem)]";
+export declare const messageItemBase = "pointer-events-auto flex items-center gap-default rounded border border-solid shadow-md px-xl py-default max-w-[calc(100vw-2rem)]";
+/**
+ * 语义类型 → 底色与描边
+ *
+ * 底色取 surface 角色（明色 10% / 暗色 26%），描边取 20% 混色；
+ * info 与 loading 同用 primary 系，error 落在 danger 系。
+ */
+export declare const messageTypeSurfaceMap: Record<StMessageType, string>;
 /**
  * 管理者用的过渡类（时长与缓动对齐参考实现 ln-message）
  *

package/dist/components/st-splitter/index.d.ts

@@ -1,8 +1,10 @@
 export declare const StSplitter: {
     new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./index.ts').StSplitterProps> & Readonly<{
         onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }>, import('./index.ts').StSplitterExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }, import('vue').PublicProps, {
         direction: import('./index.ts').StSplitterDirection;
         showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -15,6 +17,7 @@ export declare const StSplitter: {
         Defaults: {};
     }, Readonly<import('./index.ts').StSplitterProps> & Readonly<{
         onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }>, import('./index.ts').StSplitterExpose, {}, {}, {}, {
         direction: import('./index.ts').StSplitterDirection;
         showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -24,8 +27,10 @@ export declare const StSplitter: {
     __isSuspense?: never;
 } & import('vue').ComponentOptionsBase<Readonly<import('./index.ts').StSplitterProps> & Readonly<{
     onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }>, import('./index.ts').StSplitterExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }, string, {
     direction: import('./index.ts').StSplitterDirection;
     showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -35,16 +40,12 @@ export declare const StSplitter: {
     StSplitterPanel: {
         new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./index.ts').StSplitterPanelProps & {
             size?: number;
-            visible?: boolean;
         }> & Readonly<{
-            "onUpdate:visible"?: (value: boolean) => any;
             "onUpdate:size"?: (value: number) => any;
         }>, import('./index.ts').StSplitterPanelExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-            "update:visible": (value: boolean) => any;
             "update:size": (value: number) => any;
         }, import('vue').PublicProps, {
             maxSize: number;
-            flex: boolean;
             minSize: number;
         }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
             P: {};
@@ -55,13 +56,10 @@ export declare const StSplitter: {
             Defaults: {};
         }, Readonly<import('./index.ts').StSplitterPanelProps & {
             size?: number;
-            visible?: boolean;
         }> & Readonly<{
-            "onUpdate:visible"?: (value: boolean) => any;
             "onUpdate:size"?: (value: number) => any;
         }>, import('./index.ts').StSplitterPanelExpose, {}, {}, {}, {
             maxSize: number;
-            flex: boolean;
             minSize: number;
         }>;
         __isFragment?: never;
@@ -69,16 +67,12 @@ export declare const StSplitter: {
         __isSuspense?: never;
     } & import('vue').ComponentOptionsBase<Readonly<import('./index.ts').StSplitterPanelProps & {
         size?: number;
-        visible?: boolean;
     }> & Readonly<{
-        "onUpdate:visible"?: (value: boolean) => any;
         "onUpdate:size"?: (value: number) => any;
     }>, import('./index.ts').StSplitterPanelExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        "update:visible": (value: boolean) => any;
         "update:size": (value: number) => any;
     }, string, {
         maxSize: number;
-        flex: boolean;
         minSize: number;
     }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
         $slots: import('./index.ts').StSplitterPanelSlots;
@@ -86,8 +80,10 @@ export declare const StSplitter: {
     StSplitterGroup: {
         new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./index.ts').StSplitterGroupProps> & Readonly<{
             onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+            onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
         }>, import('./index.ts').StSplitterGroupExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
             resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+            collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
         }, import('vue').PublicProps, {
             direction: import('./index.ts').StSplitterDirection;
             showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -100,6 +96,7 @@ export declare const StSplitter: {
             Defaults: {};
         }, Readonly<import('./index.ts').StSplitterGroupProps> & Readonly<{
             onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+            onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
         }>, import('./index.ts').StSplitterGroupExpose, {}, {}, {}, {
             direction: import('./index.ts').StSplitterDirection;
             showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -109,8 +106,10 @@ export declare const StSplitter: {
         __isSuspense?: never;
     } & import('vue').ComponentOptionsBase<Readonly<import('./index.ts').StSplitterGroupProps> & Readonly<{
         onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }>, import('./index.ts').StSplitterGroupExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }, string, {
         direction: import('./index.ts').StSplitterDirection;
         showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -125,16 +124,12 @@ export declare const StSplitter: {
 export declare const StSplitterPanel: {
     new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./index.ts').StSplitterPanelProps & {
         size?: number;
-        visible?: boolean;
     }> & Readonly<{
-        "onUpdate:visible"?: (value: boolean) => any;
         "onUpdate:size"?: (value: number) => any;
     }>, import('./index.ts').StSplitterPanelExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        "update:visible": (value: boolean) => any;
         "update:size": (value: number) => any;
     }, import('vue').PublicProps, {
         maxSize: number;
-        flex: boolean;
         minSize: number;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
@@ -145,13 +140,10 @@ export declare const StSplitterPanel: {
         Defaults: {};
     }, Readonly<import('./index.ts').StSplitterPanelProps & {
         size?: number;
-        visible?: boolean;
     }> & Readonly<{
-        "onUpdate:visible"?: (value: boolean) => any;
         "onUpdate:size"?: (value: number) => any;
     }>, import('./index.ts').StSplitterPanelExpose, {}, {}, {}, {
         maxSize: number;
-        flex: boolean;
         minSize: number;
     }>;
     __isFragment?: never;
@@ -159,16 +151,12 @@ export declare const StSplitterPanel: {
     __isSuspense?: never;
 } & import('vue').ComponentOptionsBase<Readonly<import('./index.ts').StSplitterPanelProps & {
     size?: number;
-    visible?: boolean;
 }> & Readonly<{
-    "onUpdate:visible"?: (value: boolean) => any;
     "onUpdate:size"?: (value: number) => any;
 }>, import('./index.ts').StSplitterPanelExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:visible": (value: boolean) => any;
     "update:size": (value: number) => any;
 }, string, {
     maxSize: number;
-    flex: boolean;
     minSize: number;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: import('./index.ts').StSplitterPanelSlots;
@@ -176,8 +164,10 @@ export declare const StSplitterPanel: {
 export declare const StSplitterGroup: {
     new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./index.ts').StSplitterGroupProps> & Readonly<{
         onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }>, import('./index.ts').StSplitterGroupExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }, import('vue').PublicProps, {
         direction: import('./index.ts').StSplitterDirection;
         showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -190,6 +180,7 @@ export declare const StSplitterGroup: {
         Defaults: {};
     }, Readonly<import('./index.ts').StSplitterGroupProps> & Readonly<{
         onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+        onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
     }>, import('./index.ts').StSplitterGroupExpose, {}, {}, {}, {
         direction: import('./index.ts').StSplitterDirection;
         showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;
@@ -199,8 +190,10 @@ export declare const StSplitterGroup: {
     __isSuspense?: never;
 } & import('vue').ComponentOptionsBase<Readonly<import('./index.ts').StSplitterGroupProps> & Readonly<{
     onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }>, import('./index.ts').StSplitterGroupExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }, string, {
     direction: import('./index.ts').StSplitterDirection;
     showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;

package/dist/components/st-splitter/st-splitter-group.d.ts

@@ -2,8 +2,10 @@ import { StSplitterGroupExpose, StSplitterGroupProps, StSplitterGroupSlots } fro
 type __VLS_Slots = StSplitterGroupSlots;
 declare const __VLS_base: import('vue').DefineComponent<StSplitterGroupProps, StSplitterGroupExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }, string, import('vue').PublicProps, Readonly<StSplitterGroupProps> & Readonly<{
     onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }>, {
     direction: import('./index.ts').StSplitterDirection;
     showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;

package/dist/components/st-splitter/st-splitter-panel.d.ts

@@ -4,23 +4,17 @@ type __VLS_Slots = StSplitterPanelSlots;
 type __VLS_ModelProps = {
     /**
      * 面板尺寸双向绑定
+     * 省略时不写入，面板参与平分剩余空间
      * */
     'size'?: number;
-    /**
-     * 面板可见性双向绑定，折叠按钮与外部受控共用同一份状态
-     * */
-    'visible'?: boolean;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_base: import('vue').DefineComponent<__VLS_PublicProps, StSplitterPanelExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:visible": (value: boolean) => any;
     "update:size": (value: number) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:visible"?: (value: boolean) => any;
     "onUpdate:size"?: (value: number) => any;
 }>, {
     maxSize: number;
-    flex: boolean;
     minSize: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/st-splitter/st-splitter.d.ts

@@ -2,8 +2,10 @@ import { StSplitterExpose, StSplitterProps, StSplitterSlots } from './types/st-s
 type __VLS_Slots = StSplitterSlots;
 declare const __VLS_base: import('vue').DefineComponent<StSplitterProps, StSplitterExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     resize: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    collapse: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }, string, import('vue').PublicProps, Readonly<StSplitterProps> & Readonly<{
     onResize?: (panels: import('./index.ts').StSplitterPanelConfig[]) => any;
+    onCollapse?: (index: number, side: import('./index.ts').StSplitterBarSide, sizes: number[]) => any;
 }>, {
     direction: import('./index.ts').StSplitterDirection;
     showCollapseButton: import('./index.ts').StSplitterCollapseTrigger;

package/dist/components/st-splitter/types/st-splitter-context.d.ts

@@ -1,5 +1,25 @@
-import type { ClassValue, Ref, StyleValue } from 'vue';
-import type { StSplitterCollapseSide, StSplitterCollapseTrigger, StSplitterDirection, StSplitterPanelConfig, } from './st-splitter.d.ts';
+import type { ClassValue, ComputedRef, Ref, StyleValue } from 'vue';
+import type {
+	StSplitterBarSide,
+	StSplitterBarState,
+	StSplitterCollapseTrigger,
+	StSplitterDirection,
+	StSplitterPanelConfig,
+} from './st-splitter.d.ts';
+
+/**
+ * 面板注册参数
+ * */
+export interface StSplitterPanelRegisterOptions {
+	/** 面板唯一标识 */
+	id: string;
+	/** 显式给定的尺寸；省略时参与平分剩余空间 */
+	size?: number;
+	/** 最小尺寸 */
+	minSize: number;
+	/** 最大尺寸 */
+	maxSize: number;
+}
 
 /**
  * 分屏内部上下文接口 - 包含响应式状态
@@ -10,9 +30,13 @@ export interface StSplitterInternalContext {
 	 * */
 	direction: Ref<StSplitterDirection>;
 	/**
-	 * 面板列表
+	 * 面板配置列表（派生视图，含 collapsed）
+	 * */
+	panels: ComputedRef<StSplitterPanelConfig[]>;
+	/**
+	 * 分隔条渲染状态列表
 	 * */
-	panels: Ref<StSplitterPanelConfig[]>;
+	bars: ComputedRef<StSplitterBarState[]>;
 	/**
 	 * 当前激活的分隔条索引
 	 * */
@@ -34,26 +58,35 @@ export interface StSplitterInternalContext {
 	 * */
 	showCollapseButton: Ref<StSplitterCollapseTrigger>;
 	/**
-	 * 设置面板可见性（展开/收起动画的唯一入口）
-	 * @param id - 面板ID
-	 * @param visible - 是否可见
-	 * @param side - 收起侧位，决定收起条箭头朝向
+	 * 是否正在拖拽，用于拖拽期间关闭尺寸过渡
+	 * */
+	dragging: Ref<boolean>;
+	/**
+	 * 是否已完成首次尺寸分配，用于抑制初始渲染的过渡动画
+	 * */
+	ready: Ref<boolean>;
+	/**
+	 * 用户点击折叠入口：切换目标面板并向外抛出事件
+	 * @param barIndex - 分隔条索引
+	 * @param side - 点击的一侧
 	 * */
-	setPanelVisible: (id: string, visible: boolean, side?: StSplitterCollapseSide) => void;
+	onCollapse: (barIndex: number, side: StSplitterBarSide) => void;
 	/**
-	 * 获取收起条占用的总尺寸，未开启折叠按钮时为 0
+	 * 设置面板收起状态，side 缺省时按最近的可用邻居收起
+	 * @param panelId - 面板ID
+	 * @param collapsed - 是否收起
 	 * */
-	getCollapseBarTotalSize: () => number;
+	setPanelCollapsed: (panelId: string, collapsed: boolean) => void;
 	/**
-	 * 判断面板是否应渲染收起条
+	 * 按 ID 获取面板配置
 	 * @param id - 面板ID
 	 * */
-	isPanelBarVisible: (id: string) => boolean;
+	getPanel: (id: string) => StSplitterPanelConfig | undefined;
 	/**
-	 * 获取分隔条两侧折叠按钮的作用目标面板ID
-	 * @param visibleIndex - 分隔条归属面板在可见列表中的索引
+	 * 分隔条当前是否可拖拽（任一侧收起时不可拖拽）
+	 * @param barIndex - 分隔条索引
 	 * */
-	getCollapseTargets: (visibleIndex: number) => { startId?: string; endId?: string };
+	isDraggable: (barIndex: number) => boolean;
 	/**
 	 * splitter 容器 class
 	 * */
@@ -77,7 +110,7 @@ export interface StSplitterInternalContext {
 	/**
 	 * 注册面板
 	 * */
-	registerPanel: (panel: StSplitterPanelConfig) => void;
+	registerPanel: (options: StSplitterPanelRegisterOptions) => void;
 	/**
 	 * 注销面板
 	 * */
@@ -85,15 +118,24 @@ export interface StSplitterInternalContext {
 	/**
 	 * 开始拖拽调整尺寸
 	 * */
-	startResize: (gutterIndex: number, event: MouseEvent) => void;
+	startResize: (barIndex: number, event: MouseEvent) => void;
+	/**
+	 * 设置面板尺寸（会将该面板标记为显式尺寸）
+	 * */
+	setPanelSize: (id: string, size: number) => void;
+	/**
+	 * 按容器可用尺寸重新分配面板尺寸
+	 * */
+	resetSizes: () => void;
 	/**
-	 * 更新弹性面板尺寸
+	 * 容器尺寸变化时重算（收起面板保持收起）
 	 * */
-	updateFlexPanelSize: () => void;
+	handleContainerResize: () => void;
 	/**
-	 * 初始化面板尺寸
+	 * 初始化尺寸（首次分配，并开启过渡动画）
+	 * @param el - 容器DOM元素
 	 * */
-	initializePanelSizes: (containerEl: HTMLElement | null) => void;
+	initializeSizes: (el: HTMLElement | null) => void;
 	/**
 	 * 获取容器尺寸
 	 * */
@@ -124,14 +166,6 @@ export interface StDragState {
 	 * 起始时各面板尺寸
 	 * */
 	startSizes: number[];
-	/**
-	 * 当前鼠标X坐标
-	 * */
-	currentX?: number;
-	/**
-	 * 当前鼠标Y坐标
-	 * */
-	currentY?: number;
 }
 
 /**
@@ -180,4 +214,4 @@ export interface StConstrainedSizesResult {
 	 * 约束后的右面板尺寸
 	 * */
 	rightSize: number;
-}
+}

package/dist/components/st-splitter/types/st-splitter-group-collapse.d.ts

@@ -1,23 +1,23 @@
-/**
- * 折叠按钮所在位置
- * start 分隔条起始侧（收起归属面板）、end 分隔条结束侧（收起后一个面板）、bar 收起条（展开该面板）
- * */
-export type StSplitterGroupCollapsePosition = 'start' | 'end' | 'bar';
+import type { StSplitterBarSide } from './st-splitter.d.ts';
 
 /**
  * 折叠按钮原子属性接口
  * */
 export interface StSplitterGroupCollapseProps {
 	/**
-	 * 作用目标面板ID
+	 * 分隔条索引
+	 * */
+	barIndex: number;
+	/**
+	 * 按钮位于分隔条哪一侧：start 作用于左侧（vertical 为上侧）面板，end 作用于右侧（下侧）面板
 	 * */
-	panelId: string;
+	side: StSplitterBarSide;
 	/**
-	 * 按钮所在位置
+	 * 点击后执行的动作
 	 * */
-	side: StSplitterGroupCollapsePosition;
+	action: 'collapse' | 'restore';
 	/**
 	 * 宿主是否处于悬浮态，仅 show-collapse-button 为 hover 时生效
 	 * */
 	hovered?: boolean;
-}
+}

package/dist/components/st-splitter/types/st-splitter-group-handle.d.ts

@@ -3,7 +3,7 @@
  * */
 export interface StSplitterGroupHandleProps {
 	/**
-	 * 分隔条在可见面板中的索引
+	 * 分隔条索引，夹在 panels[index] 与 panels[index + 1] 之间
 	 * */
 	index: number;
-}
+}