@cregis/ui 1.1.10 → 1.1.12

package/dist/types/index.d.ts

@@ -64,44 +64,76 @@ export declare type ButtonSize = 'extraSmall' | 'small' | 'medium' | 'large';
 export declare type ButtonType = 'primary' | 'secondary' | 'danger' | 'foreground' | 'sameWhite';
 
 export declare const Cascader: DefineComponent<CascaderProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
-    "update:modelValue": (value: StringOrNumber) => any;
-    change: (value: StringOrNumber) => any;
+    "update:modelValue": (value: StringOrNumber | StringOrNumber[]) => any;
+    change: (value: StringOrNumber | StringOrNumber[]) => any;
     "visible-change": (value: boolean) => any;
     "filter-input": (value: string) => any;
     "filter-clear": () => any;
 }, string, PublicProps, Readonly<CascaderProps> & Readonly<{
-    "onUpdate:modelValue"?: (value: StringOrNumber) => any;
-    onChange?: (value: StringOrNumber) => any;
+    "onUpdate:modelValue"?: (value: StringOrNumber | StringOrNumber[]) => any;
+    onChange?: (value: StringOrNumber | StringOrNumber[]) => any;
     "onVisible-change"?: (value: boolean) => any;
     "onFilter-input"?: (value: string) => any;
     "onFilter-clear"?: () => any;
 }>, {
     type: "plain" | "default" | "noBorder";
     size: "small" | "medium" | "large" | "extraSmall";
+    clearText: string;
     options: CascaderRootOption[];
+    align: "left" | "center" | "right";
     maxPopperHeight: StringOrNumber;
     offset: [number, number];
-    align: "left" | "center" | "right";
     filterDebounceMs: number;
     noDataText: string;
     noMatchText: string;
     triggerWidth: StringOrNumber;
     searchText: string;
+    multiple: boolean;
+    disabledValues: StringOrNumber[];
+    showRootAll: boolean;
+    showSubAll: boolean;
+    allText: string;
+    cancelText: string;
+    confirmText: string;
     subPopperWidth: StringOrNumber;
     showSubOptionAmount: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 export declare interface CascaderEmits {
-    (e: 'update:modelValue', value: StringOrNumber): void;
-    (e: 'change', value: StringOrNumber): void;
+    (e: 'update:modelValue', value: StringOrNumber | StringOrNumber[]): void;
+    (e: 'change', value: StringOrNumber | StringOrNumber[]): void;
     (e: 'visible-change', value: boolean): void;
     (e: 'filter-input', value: string): void;
     (e: 'filter-clear'): void;
 }
 
 export declare interface CascaderProps {
-    /** 选中的 option `value`（一级或二级） */
-    modelValue?: StringOrNumber;
+    /**
+     * 选中的 option `value`
+     * - 单选：一级（无二级）或二级 option 的 `value`
+     * - 多选（`multiple`）：叶子 option `value` 数组，不包含有二级的一级 option 自身
+     */
+    modelValue?: StringOrNumber | StringOrNumber[];
+    /**
+     * 是否开启多选，默认 false；开启后下拉项带复选框，一级 option 支持半选状态。
+     * 勾选只修改草稿，底部「确定」才会发射 `update:modelValue` / `change` 并关闭浮层；「取消」或点击外部关闭会丢弃未确认的改动。
+     */
+    multiple?: boolean;
+    /**
+     * 需要禁用的 option `value` 列表（一级或二级均可），与 option 自身的 `disabled` 取并集。
+     * 禁用一级 option 时，其下所有二级 option 一并不可选。
+     */
+    disabledValues?: StringOrNumber[];
+    /** 多选时，是否在一级列表顶部显示「全部」，用于全选/取消全选所有未禁用的叶子项；默认 false */
+    showRootAll?: boolean;
+    /** 多选时，是否在每个二级面板顶部显示「全部」，用于全选/取消全选该一级下未禁用的二级项；默认 false */
+    showSubAll?: boolean;
+    /** 「全部」选项的文案，默认读取国际化文案 */
+    allText?: string;
+    /** 多选底部「清空」「取消」「确定」按钮的文案，默认读取国际化文案 */
+    clearText?: string;
+    cancelText?: string;
+    confirmText?: string;
     options?: CascaderRootOption[];
     type?: Type_3;
     size?: Size_2;
@@ -114,17 +146,17 @@ export declare interface CascaderProps {
     noMatchText?: string;
     triggerWidth?: StringOrNumber;
     popperWidth?: StringOrNumber;
-    /** 二级 Popover 宽度，默认 200px */
+    /** 二级 Tooltip 宽度，默认 200px */
     subPopperWidth?: StringOrNumber;
-    /** 一级下拉列表最大高度（纵向滚动）；默认 300px，作用于内层容器而非 Popover 根节点，以免与横向溢出策略冲突影响二级菜单 flip */
+    /** 一级下拉列表最大高度（纵向滚动）；默认 300px，作用于内层容器而非 Tooltip 根节点，以免与横向溢出策略冲突影响二级菜单 flip */
     maxPopperHeight?: StringOrNumber;
-    /** 一级下拉相对触发器的 Popper 偏移 `[skidding, distance]`，与 Popover 一致 */
+    /** 一级下拉相对触发器的 Popper 偏移 `[skidding, distance]`，与 Tooltip 一致 */
     offset?: [number, number];
     showSubOptionAmount?: boolean;
     searchText?: string;
 }
 
-/** 一级选项；有 `children` 且非空时用 Popover 展开二级 */
+/** 一级选项；有 `children` 且非空时用 Tooltip 展开二级 */
 export declare interface CascaderRootOption {
     label: string;
     value: StringOrNumber;
@@ -238,11 +270,12 @@ declare const _default: DefineComponent<DialogProps, {}, {}, {}, {}, ComponentOp
     "onUpdate:modelValue"?: (visible: boolean) => any;
     "onAfter-leave"?: () => any;
 }>, {
+    size: DialogSize;
     width: string | number;
     modelValue: boolean;
     top: string;
-    alignCenter: boolean;
     showClose: boolean;
+    alignCenter: boolean;
     closeOnClickModal: boolean;
     modal: boolean;
     lockScroll: boolean;
@@ -262,6 +295,14 @@ export declare interface DialogEmits {
 
 export declare interface DialogProps {
     modelValue: boolean;
+    /**
+     * 弹窗尺寸（同时控制宽高）
+     * - lg: 880×620
+     * - md: 780×560
+     * - sm: 656×516
+     * 同时传了 width 时，宽度以 width 为准（高度仍由 size 决定）
+     */
+    size?: DialogSize;
     width?: string | number;
     top?: string;
     alignCenter?: boolean;
@@ -271,6 +312,8 @@ export declare interface DialogProps {
     lockScroll?: boolean;
 }
 
+export declare type DialogSize = 'lg' | 'md' | 'sm';
+
 export declare const Divider: DefineComponent<DividerProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<DividerProps> & Readonly<{}>, {
     direction: "horizontal" | "vertical";
     borderStyle: "solid" | "dashed" | "dotted";
@@ -415,10 +458,12 @@ export declare const Popover: DefineComponent<PopoverProps, {
     close: () => void;
     update: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    close: () => any;
     scroll: (payload: PopoverScrollPayload) => any;
     "visible-change": (value: boolean) => any;
     "click-outside": (value: boolean) => any;
 }, string, PublicProps, Readonly<PopoverProps> & Readonly<{
+    onClose?: () => any;
     onScroll?: (payload: PopoverScrollPayload) => any;
     "onVisible-change"?: (value: boolean) => any;
     "onClick-outside"?: (value: boolean) => any;
@@ -427,18 +472,26 @@ export declare const Popover: DefineComponent<PopoverProps, {
     teleported: boolean;
     preserveContentMount: boolean;
     trigger: "hover" | "click";
-    placement: Placement;
+    clickToOpen: boolean;
+    placement: PopoverPlacement;
+    align: PopoverAlign;
+    showArrow: boolean;
     manual: boolean;
     openDelay: number;
     closeDelay: number;
+    popperWidth: string | number;
     offset: [number, number];
-    padding: string | number;
+    showClose: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
+/** 箭头对齐位置 */
+export declare type PopoverAlign = 'start' | 'center' | 'end';
+
 export declare interface PopoverEmits {
     (e: 'visible-change', value: boolean): void;
     (e: 'click-outside', value: boolean): void;
     (e: 'scroll', payload: PopoverScrollPayload): void;
+    (e: 'close'): void;
 }
 
 export declare interface PopoverInstance {
@@ -449,6 +502,9 @@ export declare interface PopoverInstance {
     update: () => void;
 }
 
+/** 浮层相对触发器的方向（箭头指向） */
+export declare type PopoverPlacement = 'top' | 'bottom' | 'left' | 'right';
+
 export declare interface PopoverPopperModifier {
     name: string;
     enabled?: boolean;
@@ -458,7 +514,7 @@ export declare interface PopoverPopperModifier {
 
 /** createPopper options 的公开子集，避免把 @popperjs/core 写进发布类型 */
 export declare interface PopoverPopperOptions {
-    placement?: Placement;
+    placement?: PopoverPlacement;
     strategy?: 'absolute' | 'fixed';
     modifiers?: PopoverPopperModifier[];
     onFirstUpdate?: (...args: unknown[]) => void;
@@ -469,7 +525,18 @@ export declare interface PopoverProps {
     teleported?: boolean;
     preserveContentMount?: boolean;
     trigger?: 'hover' | 'click';
-    placement?: Placement;
+    /**
+     * trigger 为 click 时，点击 reference 是否可以打开浮层，默认 true。
+     * 设为 false 后点击不再打开（可配合 open() / ref 手动打开）；浮层已打开时点击 reference 仍可关闭。
+     * 对 hover 触发无效。
+     */
+    clickToOpen?: boolean;
+    /** 浮层主方向，对应壳体箭头指向 */
+    placement?: PopoverPlacement;
+    /** 箭头对齐位置 */
+    align?: PopoverAlign;
+    /** 是否绘制带箭头的 SVG 壳体；下拉类场景可关闭 */
+    showArrow?: boolean;
     manual?: boolean;
     disabled?: boolean;
     /** 与默认 strategy/offset/flip 等按 modifier name 合并后再传给 createPopper */
@@ -479,7 +546,10 @@ export declare interface PopoverProps {
     popperWidth?: string | number;
     maxPopperHeight?: string | number;
     offset?: [number, number];
-    padding?: string | number;
+    /** 标题文案；也可使用 `#title` 插槽，有其一即展示标题区 */
+    title?: string;
+    /** 是否展示关闭按钮（需与 title / `#title` 同时存在 header 时生效） */
+    showClose?: boolean;
 }
 
 export declare interface PopoverScrollPayload {
@@ -525,6 +595,24 @@ export declare type RadioValue = boolean | string | number;
 
 export declare const resolveTextOverflow: (metrics: TextOverflowMetrics, axis?: TextOverflowAxis, threshold?: number) => TextOverflowState;
 
+export declare const SegmentedBar: DefineComponent<SegmentedBarProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<SegmentedBarProps> & Readonly<{}>, {
+    data: Array< SegmentedBarItem>;
+    width: string;
+    height: string;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+export declare interface SegmentedBarItem {
+    label: string;
+    percentage: number;
+    color: string;
+}
+
+export declare interface SegmentedBarProps {
+    data: Array<SegmentedBarItem>;
+    width?: string;
+    height?: string;
+}
+
 export declare const Select: DefineComponent<SelectProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     "update:modelValue": (value: StringOrNumber | StringOrNumber[]) => any;
     change: (value: StringOrNumber | StringOrNumber[]) => any;
@@ -541,8 +629,8 @@ export declare const Select: DefineComponent<SelectProps, {}, {}, {}, {}, Compon
     type: "plain" | "default" | "noBorder";
     size: "small" | "medium" | "large" | "extraSmall";
     placeholder: string;
-    maxPopperHeight: StringOrNumber;
     align: "left" | "center" | "right";
+    maxPopperHeight: StringOrNumber;
     filterDebounceMs: number;
     noDataText: string;
     noMatchText: string;
@@ -823,6 +911,84 @@ export declare interface TimelineProps {
     iconSize?: number | string;
 }
 
+export declare const Tooltip: DefineComponent<TooltipProps, {
+    isOpen: Ref<boolean>;
+    open: () => void;
+    close: () => void;
+    update: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    scroll: (payload: TooltipScrollPayload) => any;
+    "visible-change": (value: boolean) => any;
+    "click-outside": (value: boolean) => any;
+}, string, PublicProps, Readonly<TooltipProps> & Readonly<{
+    onScroll?: (payload: TooltipScrollPayload) => any;
+    "onVisible-change"?: (value: boolean) => any;
+    "onClick-outside"?: (value: boolean) => any;
+}>, {
+    disabled: boolean;
+    teleported: boolean;
+    preserveContentMount: boolean;
+    trigger: "hover" | "click";
+    placement: Placement;
+    manual: boolean;
+    openDelay: number;
+    closeDelay: number;
+    offset: [number, number];
+    padding: string | number;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare interface TooltipEmits {
+    (e: 'visible-change', value: boolean): void;
+    (e: 'click-outside', value: boolean): void;
+    (e: 'scroll', payload: TooltipScrollPayload): void;
+}
+
+export declare interface TooltipInstance {
+    isOpen: Ref<boolean>;
+    open: () => void;
+    close: () => void;
+    /** 浮层打开时重新计算定位；关闭时为 no-op */
+    update: () => void;
+}
+
+export declare interface TooltipPopperModifier {
+    name: string;
+    enabled?: boolean;
+    options?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+
+/** createPopper options 的公开子集，避免把 @popperjs/core 写进发布类型 */
+export declare interface TooltipPopperOptions {
+    placement?: Placement;
+    strategy?: 'absolute' | 'fixed';
+    modifiers?: TooltipPopperModifier[];
+    onFirstUpdate?: (...args: unknown[]) => void;
+}
+
+export declare interface TooltipProps {
+    /** 是否将浮层 Teleport 到 body，避免被父级 overflow 裁切 */
+    teleported?: boolean;
+    preserveContentMount?: boolean;
+    trigger?: 'hover' | 'click';
+    placement?: Placement;
+    manual?: boolean;
+    disabled?: boolean;
+    /** 与默认 strategy/offset/flip 等按 modifier name 合并后再传给 createPopper */
+    tooltipOptions?: TooltipPopperOptions;
+    openDelay?: number;
+    closeDelay?: number;
+    popperWidth?: string | number;
+    maxPopperHeight?: string | number;
+    offset?: [number, number];
+    padding?: string | number;
+}
+
+export declare interface TooltipScrollPayload {
+    scrollTop: number;
+    scrollLeft: number;
+}
+
 export declare type Type = 'primary' | 'info' | 'success' | 'warning' | 'danger';
 
 declare type Type_2 = 'default' | 'plain' | 'noBorder';
@@ -875,6 +1041,25 @@ export declare interface UploadProps {
  */
 export declare function useClickOutside(target: ClickOutsideTarget | ClickOutsideTarget[], callback: (event: PointerEvent) => void, options?: ClickOutsideOptions): void;
 
+/**
+ * 为浮层（Popover / Tooltip）接入 `motion-flotation` 进出场动画。
+ *
+ * motion-flotation（@cregis/tokens）是状态驱动：默认为隐藏态（opacity 0 + 位移 + 缩放），
+ * 加上 `is-active` 才过渡到可见态；移除 `is-active` 则走离场过渡。
+ * 因此用 JS 钩子接管 `<Transition :css="false">`：
+ * 入场时补上 is-active，离场时移除 is-active，并等过渡时长结束后再调用 done 卸载/隐藏节点。
+ *
+ * 使用：
+ * - 浮层根节点加 class `motion-flotation` 和 `{ 'is-active': motionActive }`
+ * - `<Transition :css="false" @enter="onEnter" @leave="onLeave">`
+ * - 定位该节点的 Popper 需 `computeStyles.gpuAcceleration = false`，把 transform 留给动画
+ */
+export declare function useFlotationMotion(): {
+    motionActive: Ref<boolean, boolean>;
+    onEnter: (el: Element, done: () => void) => void;
+    onLeave: (el: Element, done: () => void) => void;
+};
+
 /**
  * 检测元素是否因内容溢出而产生省略/截断。
  * 不负责写入省略样式，调用方需自行设置 overflow + text-overflow / line-clamp。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cregis/ui",
   "private": false,
-  "version": "1.1.10",
+  "version": "1.1.12",
   "type": "module",
   "files": [
     "dist"
@@ -27,7 +27,7 @@
   },
   "peerDependencies": {
     "@cregis/icon": "^0.1.10",
-    "@cregis/tokens": "^1.0.0",
+    "@cregis/tokens": "1.0.8",
     "vue": "^3.5.0",
     "vue-i18n": "^11.0.0"
   },
@@ -35,7 +35,7 @@
     "@commitlint/cli": "^20.1.0",
     "@commitlint/config-conventional": "^20.0.0",
     "@cregis/icon": "^0.1.14",
-    "@cregis/tokens": "^1.0.8",
+    "@cregis/tokens": "link:../cregis-ui-tokens",
     "@popperjs/core": "^2.11.8",
     "@rushstack/eslint-patch": "^1.14.1",
     "@types/lodash-es": "^4.17.12",