straw-ui-vue 0.1.63 → 0.2.1

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;
-}
+}

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

@@ -1,5 +1,10 @@
 import type { ClassValue, StyleValue, VNodeChild } from 'vue';
-import type { StSplitterCollapseTrigger, StSplitterDirection, StSplitterPanelConfig } from './st-splitter.d.ts';
+import type {
+	StSplitterBarSide,
+	StSplitterCollapseTrigger,
+	StSplitterDirection,
+	StSplitterPanelConfig,
+} from './st-splitter.d.ts';
 
 /**
  * 分屏容器组属性接口
@@ -49,6 +54,8 @@ export interface StSplitterGroupSlots {
 export interface StSplitterGroupEmits {
 	/** 面板尺寸变化事件（拖拽结束时触发） */
 	resize: [panels: StSplitterPanelConfig[]];
+	/** 收起/恢复事件 */
+	collapse: [index: number, side: StSplitterBarSide, sizes: number[]];
 }
 
 /**
@@ -59,6 +66,8 @@ export interface StSplitterGroupExpose {
 	getPanels: () => StSplitterPanelConfig[];
 	/** 设置面板尺寸 */
 	setPanelSize: (id: string, size: number) => void;
+	/** 设置面板收起状态 */
+	setPanelCollapsed: (id: string, collapsed: boolean) => void;
 	/** 重置面板尺寸 */
 	resetSizes: () => void;
-}
+}

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

@@ -5,6 +5,11 @@ import type { StSplitterPanelConfig } from './st-splitter.d.ts';
  * 面板组件属性接口
  * */
 export interface StSplitterPanelProps {
+	/**
+	 * 面板尺寸（px）
+	 * 省略时与其余未指定尺寸的面板平分剩余空间
+	 * */
+	size?: number;
 	/**
 	 * 最小尺寸
 	 * */
@@ -13,10 +18,6 @@ export interface StSplitterPanelProps {
 	 * 最大尺寸
 	 * */
 	maxSize?: number;
-	/**
-	 * 是否为弹性面板，自动填充剩余空间
-	 * */
-	flex?: boolean;
 	/**
 	 * 面板 class
 	 * */
@@ -41,6 +42,6 @@ export interface StSplitterPanelSlots {
 export interface StSplitterPanelExpose {
 	/** 获取面板配置 */
 	getConfig: () => StSplitterPanelConfig;
-	/** 设置面板可见性 */
-	setVisible: (visible: boolean) => void;
-}
+	/** 设置面板收起状态 */
+	setCollapsed: (collapsed: boolean) => void;
+}

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

@@ -12,9 +12,14 @@ export type StSplitterDirection = 'horizontal' | 'vertical';
 export type StSplitterCollapseTrigger = 'never' | 'hover' | 'always';
 
 /**
- * 面板收起侧位类型，决定收起条上展开按钮的箭头朝向
+ * 分隔条侧位：start 作用于分隔条左侧（vertical 为上侧）面板，end 作用于右侧（下侧）面板
  * */
-export type StSplitterCollapseSide = 'start' | 'end';
+export type StSplitterBarSide = 'start' | 'end';
+
+/**
+ * 折叠入口动作：collapse 收起该侧面板、restore 恢复该侧面板
+ * */
+export type StSplitterCollapseAction = 'collapse' | 'restore';
 
 /**
  * 面板配置接口
@@ -25,37 +30,57 @@ export interface StSplitterPanelConfig {
 	 * */
 	id: string;
 	/**
-	 * 当前尺寸
+	 * 当前尺寸（px）
 	 * */
 	size: number;
 	/**
 	 * 最小尺寸
 	 * */
-	minSize?: number;
+	minSize: number;
 	/**
 	 * 最大尺寸
 	 * */
-	maxSize?: number;
+	maxSize: number;
+	/**
+	 * 是否处于收起态，等价于 size === 0
+	 * */
+	collapsed: boolean;
+	/**
+	 * 收起前尺寸，仅在收起态保留，用于恢复
+	 * */
+	prevSize?: number;
 	/**
-	 * 期望尺寸，用于恢复时使用
+	 * 空间寄存在哪个面板，仅在收起态保留
 	 * */
-	desiredSize?: number;
+	lenderId?: string;
+}
+
+/**
+ * 分隔条上的一个折叠入口
+ * */
+export interface StSplitterBarArrow {
 	/**
-	 * 是否为弹性面板
+	 * 作用目标面板ID
 	 * */
-	flex?: boolean;
+	panelId: string;
 	/**
-	 * 是否可见
+	 * 点击后执行的动作
 	 * */
-	visible: boolean;
+	action: StSplitterCollapseAction;
+}
+
+/**
+ * 分隔条渲染状态
+ * */
+export interface StSplitterBarState {
 	/**
-	 * 收起侧位，决定收起条上展开按钮的箭头朝向
+	 * 分隔条索引，夹在 panels[index] 与 panels[index + 1] 之间
 	 * */
-	collapsedSide?: StSplitterCollapseSide;
+	index: number;
 	/**
-	 * 是否处于展开/收起动画中，动画期间不向外同步尺寸
+	 * 两侧可用的折叠入口
 	 * */
-	animating?: boolean;
+	arrows: Partial<Record<StSplitterBarSide, StSplitterBarArrow>>;
 }
 
 /**
@@ -96,8 +121,10 @@ export interface StSplitterProps {
  * 分屏组件事件接口
  * */
 export interface StSplitterEmits {
-	/** 面板尺寸变化事件 */
+	/** 面板尺寸变化事件（拖拽结束时触发） */
 	resize: [panels: StSplitterPanelConfig[]];
+	/** 收起/恢复事件，index 为分隔条索引，side 为点击的一侧 */
+	collapse: [index: number, side: StSplitterBarSide, sizes: number[]];
 }
 
 /**
@@ -116,6 +143,8 @@ export interface StSplitterExpose {
 	getPanels: () => StSplitterPanelConfig[];
 	/** 设置面板尺寸 */
 	setPanelSize: (id: string, size: number) => void;
+	/** 设置面板收起状态 */
+	setPanelCollapsed: (id: string, collapsed: boolean) => void;
 	/** 重置面板尺寸 */
 	resetSizes: () => void;
-}
+}

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

@@ -1,6 +1,6 @@
 import { Ref } from 'vue';
 import { StConstrainedSizesOptions, StConstrainedSizesResult, StSplitterInternalContext } from './types/st-splitter-context.d.ts';
-import { StSplitterCollapseTrigger, StSplitterDirection } from './types/st-splitter.d.ts';
+import { StSplitterBarSide, StSplitterCollapseTrigger, StSplitterDirection } from './types/st-splitter.d.ts';
 /**
  * 计算调整后的尺寸，考虑边界约束
  * 确保左右面板尺寸都在各自的 min/max 范围内
@@ -11,8 +11,12 @@ export declare function calculateConstrainedSizes(options: StConstrainedSizesOpt
 /**
  * 分屏组件 composable
  * 每次调用都会创建独立的状态实例，支持多个分屏组件并存
+ *
+ * 收起模型：尺寸在分隔条两侧的相邻面板之间一对一转移，
+ * 每个面板自行记录收起前尺寸与空间寄存的面板，恢复时按记录扣回。
  * @param direction - 分屏方向的响应式引用
  * @param showCollapseButton - 折叠按钮显示时机的响应式引用
+ * @param onCollapse - 用户点击折叠入口后的回调
  * @returns 分屏上下文对象
  * */
-export declare function useSplitter(direction: Ref<StSplitterDirection>, showCollapseButton?: Ref<StSplitterCollapseTrigger>): StSplitterInternalContext;
+export declare function useSplitter(direction: Ref<StSplitterDirection>, showCollapseButton?: Ref<StSplitterCollapseTrigger>, onCollapse?: (index: number, side: StSplitterBarSide, sizes: number[]) => void): StSplitterInternalContext;

package/dist/components/st-table/tableStyle.d.ts

@@ -1,7 +1,7 @@
 import { StTableColumn } from './types/st-table.d.ts';
 import { StTableContext } from './types/st-table-context.d.ts';
-/** 斑马行底色（= muted 以 40% 压在 background 上的不透明合成色） */
-export declare const TABLE_STRIPE_BG = "bg-[color-mix(in_srgb,var(--muted)_40%,var(--background))]";
+/** 斑马行底色（= neutral 以 50% 压在 background 上的不透明合成色） */
+export declare const TABLE_STRIPE_BG = "bg-neutral-subtle-weak";
 /** 行条带背景（仅斑马行着色，其余保持透明继承容器底色） */
 export declare function tableStripeClass(stripe: boolean | undefined, rowIndex: number): string;
 /** 需遮住下层滚动内容的背景（固定列单元格、合并覆盖层） */

package/dist/constants/choice-row.d.ts

@@ -2,4 +2,4 @@
  * 选项行基础类名
  * st-menu-item / st-select-item 共用，保证选项行视觉一致
  * */
-export declare const choiceRowClasses = "flex items-center gap-2 px-3 py-1.25 rounded cursor-pointer transition-colors duration-100 select-none whitespace-nowrap text-3.25 leading-5 text-foreground hover:bg-accent";
+export declare const choiceRowClasses = "flex items-center gap-2 px-3 py-1.25 rounded cursor-pointer transition-colors duration-100 select-none whitespace-nowrap text-3.25 leading-5 text-foreground hover:bg-neutral-subtle";

package/dist/constants/config.d.ts

@@ -4,7 +4,7 @@ import { StConfigKey } from '../types/config.d.ts';
  *
  * 第一次 nextZIndex() 返回 Z_INDEX_BASE + 1，可通过 setConfig('global', { Z_INDEX_BASE }) 覆盖。
  */
-export declare const Z_INDEX_BASE = 1000;
+export { Z_INDEX_BASE } from './z-index.ts';
 /**
  * global 命名空间中会下沉为各预封装组件默认值的键
  *

package/dist/constants/z-index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 层级（z-index）规范
+ *
+ * 全库的 z-index 只有两类合法来源：
+ * 1. 本文件的命名层：需要跨组件比较层级的部件（浮层、容器内浮动件、容器级交互件）；
+ * 2. 组件内部层：值域 0–Z_LAYER_INTERNAL_MAX，只在组件自己的层叠上下文内比较，
+ *    组件根必须建立层叠上下文（isolate），否则内部数值会泄漏到外部参与比较。
+ *
+ * 分层（由低到高）：
+ *   0      内容
+ *   0–99   组件内部层（表格固定列、滚轮高亮、角标等）
+ *   100    容器内浮动件（滚动条轨道/滑块/导航/回顶）
+ *   200    容器级交互件（分隔条与折叠按钮）
+ *   1000+  浮层（dialog / drawer / popover / panel / message）
+ */
+/** 组件内部层上限，超过此值的 z-index 必须登记为命名层 */
+export declare const Z_LAYER_INTERNAL_MAX = 99;
+/** 容器内浮动件：浮在容器内容之上、不与容器级交互件竞争 */
+export declare const Z_LAYER_CHROME = 100;
+/** 容器级交互件：必须压过容器内一切浮动件（如分隔条压过滚动条） */
+export declare const Z_LAYER_CONTAINER = 200;
+/**
+ * 浮层 z-index 起始值默认值
+ *
+ * 第一次 nextZIndex() 返回 Z_INDEX_BASE + 1，可通过 setConfig('global', { Z_INDEX_BASE }) 覆盖。
+ */
+export declare const Z_INDEX_BASE = 1000;