straw-ui-vue 0.1.44 → 0.1.45

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

@@ -1,8 +1,8 @@
 import { StPickerRangeValue, StPickerTimeColumnItem, StPickerTimeParts, StPickerValue } from './types/st-picker-shared.d.ts';
 /** 星期表头，周日起始，与日历栅格同序 */
 export declare const weekDayLabels: string[];
-/** 年代面板跨度：4×3 共 12 年 */
-export declare const DECADE_SPAN = 12;
+/** 年面板跨度：4×4 共 16 年，与月面板的 3×4 同占满一档定高 */
+export declare const DECADE_SPAN = 16;
 /**
  * 按格式串格式化日期
  * @param date - 日期，空值返回空串
@@ -66,7 +66,7 @@ export declare function lastOfMonth(date: Date): Date;
  * */
 export declare function startOfWeek(date: Date, weekStartsOn?: number): Date;
 /**
- * 年代起始年（12 年一档）
+ * 年面板起始年（16 年一档）
  * */
 export declare function startOfDecade(year: number): number;
 /**
@@ -74,7 +74,7 @@ export declare function startOfDecade(year: number): number;
  * */
 export declare function createMonthMatrix(year: number, month: number): Date[];
 /**
- * 年代面板年份列表（12 项）
+ * 年面板年份列表（16 项）
  * */
 export declare function createDecadeYears(decadeStart: number): number[];
 /**

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

@@ -25,7 +25,6 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_PublicProps, StDat
     floatingLabel: boolean;
     format: string;
     icon: string;
-    closeOnSelect: boolean;
     range: boolean;
     valueFormat: string;
     startPlaceholder: string;

package/dist/components/st-date-picker/desktop/types/st-date-picker-desktop.d.ts

@@ -44,8 +44,6 @@ export interface StDatePickerDesktopProps extends StPickerDateConstraintProps, S
 	showClear?: boolean;
 	/** 面板底部是否显示今天直达 */
 	showTodayLink?: boolean;
-	/** 选择完成后是否自动收起浮层 */
-	closeOnSelect?: boolean;
 	/** 浮层容器类名 */
 	popoverClass?: ClassValue;
 	/** 浮层容器样式 */

package/dist/components/st-date-picker/desktop/usePickerShell.d.ts

@@ -0,0 +1,43 @@
+/** usePickerShell 入参，`T` 为端点类型：日期为 Date，时刻为 StPickerTimeParts */
+export interface UsePickerShellOptions<T> {
+    /** 是否区间模式 */
+    range: () => boolean;
+    /** 区间两端连接符 */
+    separator: () => string;
+    /** 区间开始端占位 */
+    startPlaceholder: () => string;
+    /** 区间结束端占位 */
+    endPlaceholder: () => string;
+    /** 单点值 */
+    value: () => T | null;
+    /** 区间两端值 */
+    rangeValue: () => [T | null, T | null];
+    /** 单端回显文本 */
+    describe: (value: T) => string;
+    /** 组件级 clearable 开关 */
+    clearable: () => boolean;
+    /** 禁用态 */
+    disabled: () => boolean;
+    /** 显隐变化的同一轮内同步执行：按绑定值重建内部状态，让面板拿到的 props 已是新值 */
+    beforeOpen?: () => void;
+    /** 面板挂载后执行：定位视图并聚焦触发器 */
+    onOpened?: () => void;
+    /** 浮层关闭后执行：丢弃草稿、恢复镜像 */
+    onClosed?: () => void;
+}
+/**
+ * 桌面端选择器的浮层外壳状态
+ *
+ * 三件 desktop 预封装在可见态、键入报错态、触发器回显镜像与显隐钩子顺序上完全一致，
+ * 差异只在面板定位与落值口径，那部分留在各件里。
+ * */
+export declare function usePickerShell<T = Date>(options: UsePickerShellOptions<T>): {
+    visible: import('vue').Ref<boolean, boolean>;
+    error: import('vue').Ref<boolean, boolean>;
+    displayText: import('vue').ComputedRef<string>;
+    hasValue: import('vue').ComputedRef<boolean>;
+    clearableVisible: import('vue').ComputedRef<boolean>;
+    open: () => void;
+    close: () => void;
+    handleVisibleChange: (next: boolean) => void;
+};

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

@@ -148,7 +148,6 @@ export declare const StDatePicker: {
             floatingLabel: boolean;
             format: string;
             icon: string;
-            closeOnSelect: boolean;
             range: boolean;
             valueFormat: string;
             startPlaceholder: string;
@@ -185,7 +184,6 @@ export declare const StDatePicker: {
             floatingLabel: boolean;
             format: string;
             icon: string;
-            closeOnSelect: boolean;
             range: boolean;
             valueFormat: string;
             startPlaceholder: string;
@@ -224,7 +222,6 @@ export declare const StDatePicker: {
         floatingLabel: boolean;
         format: string;
         icon: string;
-        closeOnSelect: boolean;
         range: boolean;
         valueFormat: string;
         startPlaceholder: string;
@@ -430,6 +427,7 @@ export declare const StDatePicker: {
     }>, {
         size: import('./index.ts').StPickerCellSize;
         columns: number;
+        fill: boolean;
         scrollable: boolean;
         scrollToSelected: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
@@ -1627,7 +1625,6 @@ export declare const StDatePickerDesktop: {
         floatingLabel: boolean;
         format: string;
         icon: string;
-        closeOnSelect: boolean;
         range: boolean;
         valueFormat: string;
         startPlaceholder: string;
@@ -1664,7 +1661,6 @@ export declare const StDatePickerDesktop: {
         floatingLabel: boolean;
         format: string;
         icon: string;
-        closeOnSelect: boolean;
         range: boolean;
         valueFormat: string;
         startPlaceholder: string;
@@ -1703,7 +1699,6 @@ export declare const StDatePickerDesktop: {
     floatingLabel: boolean;
     format: string;
     icon: string;
-    closeOnSelect: boolean;
     range: boolean;
     valueFormat: string;
     startPlaceholder: string;
@@ -2595,6 +2590,7 @@ export declare const StPickerCellGrid: import('vue').DefineComponent<import('./i
 }>, {
     size: import('./index.ts').StPickerCellSize;
     columns: number;
+    fill: boolean;
     scrollable: boolean;
     scrollToSelected: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
@@ -2907,6 +2903,6 @@ export * from './usePickerDate.ts';
 export * from './usePickerTime.ts';
 export * from './usePickerModel.ts';
 export { dateShortcuts, dateRangeShortcuts, timeShortcuts, timeRangeShortcuts, dateTimeShortcuts, dateTimeRangeShortcuts, } from './shortcuts.ts';
-export { pickerCellVariants, pickerChipClasses, pickerDividerClasses, pickerFocusRing, pickerFooterClasses, pickerHintClasses, pickerLabelClasses, pickerLinkClasses, pickerMiniInputVariants, pickerNavVariants, pickerPanelVariants, pickerQuickVariants, pickerSegmentValueClasses, pickerSegmentVariants, pickerTagVariants, pickerTimeItemVariants, pickerTitleVariants, } from './picker-classes.ts';
+export { pickerCellVariants, pickerChipClasses, pickerDividerClasses, pickerFocusRing, pickerFooterClasses, pickerHintClasses, pickerLabelClasses, pickerLinkClasses, pickerMiniInputVariants, pickerNavVariants, pickerPanelVariants, pickerQuickVariants, pickerSegmentValueClasses, pickerSegmentVariants, pickerTagVariants, pickerTimeItemVariants, pickerTitleVariants, pickerViewVariants, } from './picker-classes.ts';
 export default StDatePicker;
 export type * from './types/index.d.ts';

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

@@ -5,6 +5,18 @@ export declare const pickerFocusRing = "outline-none focus-visible:outline-2 foc
  * 边框 / 底色 / 圆角 / 投影由 StPopover 与 StDrawer 提供，此处只定宽与裁剪，避免二次描边
  * */
 export declare const pickerPanelVariants: import('../../types').CVAReturnFunction<import('../../types').VariantValues>;
+/**
+ * 日历视图体：星期行 + 日期格，或月 / 年宫格
+ *
+ * 三态共用同一高度，切态只换内容不改容器尺寸，浮层不会因内容变高而跳动
+ * （st-popover 没有 ResizeObserver，内容变高不会重算位置）。
+ * 月 / 年宫格用 fill 撑满这一档高度：格子行高固定 62px、月与年都是 4 行，残余走 content-center
+ * 均分成上下边距，既不在上下留大空档也不把格子拉成厚板。
+ *
+ * h-64.5 = 258px，按 pc 档实测算得：星期行 34 + 日期格 6×34 + 5×2 间隙 + 容器下内边距 10。
+ * 实测三态原高 347 / 243 / 207，跨度 140px。cellSize 非 pc 档时不要开 fixed（高度对不上）。
+ * */
+export declare const pickerViewVariants: import('../../types').CVAReturnFunction<import('../../types').VariantValues>;
 /** 日历 / 月 / 年 单元格，tone 与 radius 两个轴各管一类属性，互不冲突 */
 export declare const pickerCellVariants: import('../../types').CVAReturnFunction<import('../../types').VariantValues>;
 /** 时间列选项行（PC 双列与 DateTime 时间视图共用） */

package/dist/components/st-date-picker/st-picker-cell-grid.d.ts

@@ -13,6 +13,7 @@ declare const __VLS_export: import('vue').DefineComponent<StPickerCellGridProps,
 }>, {
     size: import('./index.ts').StPickerCellSize;
     columns: number;
+    fill: boolean;
     scrollable: boolean;
     scrollToSelected: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/components/st-date-picker/types/st-picker-atoms.d.ts

@@ -157,6 +157,8 @@ export interface StPickerCellGridProps {
 	size?: StPickerCellSize;
 	/** 是否限制最大高度并滚动（H5 年份条） */
 	scrollable?: boolean;
+	/** 撑满父容器高度：行数均分、格子随行高拉伸，用于与日视图等高 */
+	fill?: boolean;
 	/** 选中项自动滚入视口 */
 	scrollToSelected?: boolean;
 	/** 类名 */
@@ -401,7 +403,7 @@ export interface StPickerTriggerProps {
 export interface StPickerTriggerEmits {
 	/** 清空 */
 	clear: [];
-	/** 失焦或回车提交键入文本，由外层负责宽松解析与规范化 */
+	/** 失焦或回车提交键入文本，暂存与回显一致时不发出；由外层负责宽松解析与规范化 */
 	commit: [text: string];
 }
 

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

@@ -1,7 +1,7 @@
 import { StPickerCalendarLevel } from './types/st-picker-shared.d.ts';
 /** 日历视图状态入参 */
 export interface UseCalendarViewOptions {
-    /** 打开面板时的定位日期，通常取已选值；为空时定位今天 */
+    /** 初始视图定位日期，构造时读一次；为空时定位今天。再次打开时的定位由调用方走 `locate` */
     getLocateDate?: () => Date | null | undefined;
 }
 /**
@@ -25,7 +25,6 @@ export declare function useCalendarView(options?: UseCalendarViewOptions): {
     pickYear: (value: number) => void;
     pickMonth: (value: number) => void;
     goLevel: (next: StPickerCalendarLevel) => void;
-    reopen: () => void;
 };
 /** 日期禁用判定入参 */
 export interface UseDateConstraintsOptions {

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

@@ -1,6 +1,6 @@
 import { MaybeRefOrGetter } from 'vue';
-/** 回显文本构建入参 */
-export interface UsePickerMirrorOptions {
+/** 回显文本构建入参，`T` 为端点类型：日期为 Date，时刻为 StPickerTimeParts */
+export interface UsePickerMirrorOptions<T> {
     /** 是否区间模式 */
     range: MaybeRefOrGetter<boolean>;
     /** 区间两端连接符 */
@@ -10,11 +10,11 @@ export interface UsePickerMirrorOptions {
     /** 区间结束端占位 */
     endPlaceholder: MaybeRefOrGetter<string>;
     /** 单点值 */
-    value: () => Date | null;
+    value: () => T | null;
     /** 区间两端值 */
-    rangeValue: () => [Date | null, Date | null];
+    rangeValue: () => [T | null, T | null];
     /** 单端格式化 */
-    describe: (date: Date) => string;
+    describe: (value: T) => string;
 }
 /**
  * 触发器回显文本
@@ -22,7 +22,7 @@ export interface UsePickerMirrorOptions {
  * 桌面端与手机端共用同一套镜像规则：区间半成型时未选端显示该端占位符，
  * 两端皆空则整体回退到空串（让输入框呈现真正的空态而不是两段占位）。
  * */
-export declare function usePickerMirror(options: UsePickerMirrorOptions): {
+export declare function usePickerMirror<T = Date>(options: UsePickerMirrorOptions<T>): {
     displayText: import('vue').ComputedRef<string>;
     hasValue: import('vue').ComputedRef<boolean>;
 };

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

@@ -730,6 +730,7 @@ export declare const StScrollbar: {
             keyField?: string;
             itemSize?: number;
             minItemSize?: number | ((item: T, index: number) => number);
+            gap?: number;
             overscan?: number;
             onEvent?: (name: string, ...args: any[]) => any;
             onRangeChange?: (start: number, end: number) => any;
@@ -1606,6 +1607,7 @@ export declare const StScrollbarGroupVirtual: <T>(__VLS_props: NonNullable<Await
         keyField?: string;
         itemSize?: number;
         minItemSize?: number | ((item: T, index: number) => number);
+        gap?: number;
         overscan?: number;
         onEvent?: (name: string, ...args: any[]) => any;
         onRangeChange?: (start: number, end: number) => any;

package/dist/components/st-scrollbar/types/st-scrollbar-group-virtual.d.ts

@@ -29,6 +29,8 @@ export interface StScrollbarGroupVirtualProps<T = unknown> {
 	itemSize?: number;
 	/** 最小项尺寸，动态高度模式必填，传 number 时视为统一估算值 */
 	minItemSize?: number | ((item: T, index: number) => number);
+	/** 相邻项之间的间距(px)，仅作用于虚拟化排布，末项之后不计间距，默认 0 */
+	gap?: number;
 	/** 视口外预渲染项数，默认 5 */
 	overscan?: number;
 }

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

@@ -35,6 +35,8 @@ export interface StScrollbarVirtualConfigProps<T = unknown> {
 	itemSize?: number;
 	/** 最小项尺寸，动态高度模式必填，传 number 时视为统一估算值 */
 	minItemSize?: number | ((item: T, index: number) => number);
+	/** 相邻项之间的间距(px)，仅虚拟滚动生效，末项之后不计间距，默认 0 */
+	gap?: number;
 	/** 视口外预渲染项数，默认 5 */
 	overscan?: number;
 }

package/dist/components/st-scrollbar/useVirtualScrollbar.d.ts

@@ -8,6 +8,8 @@ export interface VirtualScrollbarOptions {
     count: Ref<number>;
     /** 固定项尺寸(px)，有值时走定高快速路径 */
     fixedSize: Ref<number | undefined>;
+    /** 相邻项间距(px)，缺省视为 0；仅作用于排布，末项之后不计 */
+    gap?: Ref<number>;
     /** 获取指定索引的预估尺寸 */
     estimateAt: (index: number) => number;
     /** 视口外预渲染项数 */
@@ -47,6 +49,8 @@ export declare function useVirtualScrollbar(options: VirtualScrollbarOptions): {
     reset: (n: number) => void;
     syncCount: (n: number) => void;
     refreshEstimates: () => void;
+    /** 间距等排布输入变化时重算偏移表并推进滚动校正 */
+    relayout: () => void;
     scrollToIndex: (index: number, options?: StScrollbarVirtualScrollToIndexOptions) => void;
     scrollToOffset: (offset: number, options?: StScrollbarVirtualScrollToOffsetOptions) => void;
     getTotalSize: () => number;