@cregis/ui 1.0.12 → 1.0.14

package/dist/types/index.d.ts

@@ -175,6 +175,15 @@ export declare interface CheckboxProps {
     indeterminate?: boolean;
 }
 
+export declare interface ClickOutsideOptions {
+    /** 忽略的元素列表，点击这些元素内部不会触发回调（如触发弹窗的按钮） */
+    ignore?: ClickOutsideTarget[];
+    /** 是否在捕获阶段监听，默认 true，可穿透子元素的 event.stopPropagation() */
+    capture?: boolean;
+}
+
+export declare type ClickOutsideTarget = MaybeRef<HTMLElement | null | undefined>;
+
 /** 函数式确认弹框，点击确定 resolve，点击取消 reject('cancel') */
 declare function confirm_2(source: ConfirmParam): Promise<void>;
 export { confirm_2 as confirm }
@@ -280,6 +289,8 @@ export declare interface DividerProps {
     length?: string;
 }
 
+export declare const getDialogZIndex: () => number;
+
 export declare type IconButtonType = 'rectangle' | 'square' | 'circle' | 'professional';
 
 export declare const Input: DefineComponent<InputProps, {
@@ -342,6 +353,8 @@ export declare interface InputProps {
 
 export declare type LanguageKey = 'zh-CN' | 'zh-TW' | 'en-US';
 
+declare type MaybeRef<T> = T | Ref<T>;
+
 /** 函数式轻提示，默认停留 1s，可通过对象配置时长；已有提示展示时忽略新调用 */
 export declare function Message(source: MessageParam): void;
 
@@ -546,6 +559,8 @@ export declare interface SelectScrollPayload {
 
 export declare const setCregisUILocale: (lang: LanguageKey) => void;
 
+export declare const setDialogZIndex: (_zIndex: number) => void;
+
 declare type Size = 'large' | 'medium' | 'small' | 'extraSmall';
 
 declare type Size_2 = 'large' | 'medium' | 'small' | 'extraSmall';
@@ -678,6 +693,48 @@ export declare type TagSize = 'small' | 'medium' | 'large';
 
 declare type TagType = 'subtle' | 'solid' | 'gray' | 'strokeSubtle' | 'strokeSolid' | 'danger' | 'warning' | 'success' | 'ready' | 'invalid' | 'apricot' | 'khaki' | 'grass' | 'sage' | 'cyan' | 'iceBlue' | 'periwinkle' | 'lilac' | 'orchid' | 'mallow' | 'rose' | 'coral' | 'mauve' | 'moss' | 'steel' | 'grape' | 'sameWhite' | 'lime';
 
+export declare const Timeline: DefineComponent<TimelineProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<TimelineProps> & Readonly<{}>, {
+    dotSize: number | string;
+    dotColor: string;
+    lineColor: string;
+    lineWidth: number | string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TIMELINE_KEY: InjectionKey<TimelineContext>;
+
+export declare interface TimelineContext {
+    dotSize: Ref<number | string>;
+    dotColor: Ref<string>;
+    lineColor: Ref<string>;
+    lineWidth: Ref<number | string>;
+}
+
+export declare const TimelineItem: DefineComponent<TimelineItemProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<TimelineItemProps> & Readonly<{}>, {
+    contentHoverable: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare interface TimelineItemProps {
+    /** 节点圆点直径，可覆盖 Timeline 默认值 */
+    dotSize?: number | string;
+    /** 节点圆点颜色，可覆盖 Timeline 默认值 */
+    dotColor?: string;
+    /** 连接线宽度，可覆盖 Timeline 默认值 */
+    lineWidth?: number | string;
+    /** content 区域是否启用 hover 背景，默认 true */
+    contentHoverable?: boolean;
+}
+
+export declare interface TimelineProps {
+    /** 节点圆点直径，默认 8 */
+    dotSize?: number | string;
+    /** 节点圆点颜色，默认绿色 */
+    dotColor?: string;
+    /** 连接线颜色 */
+    lineColor?: string;
+    /** 连接线宽度，默认 2 */
+    lineWidth?: number | string;
+}
+
 export declare type Type = 'primary' | 'info' | 'success' | 'warning' | 'danger';
 
 declare type Type_2 = 'default' | 'plain' | 'noBorder';
@@ -707,4 +764,20 @@ export declare interface UploadProps {
     onChange?: (file: FormData) => void;
 }
 
+/**
+ * 点击目标元素外部时触发回调的 Hook。
+ *
+ * - 使用 pointerdown + click 组合，精准区分「拖拽」与「点击外部」
+ * - capture 默认开启，不被子节点 stopPropagation 干扰
+ * - 支持单个或多个目标元素，支持 ignore 排除列表
+ *
+ * @example
+ * const panelRef = ref<HTMLElement>()
+ * useClickOutside(panelRef, () => closePanel())
+ *
+ * @example
+ * useClickOutside([panelRef, triggerRef], callback, { ignore: [buttonRef] })
+ */
+export declare function useClickOutside(target: ClickOutsideTarget | ClickOutsideTarget[], callback: (event: PointerEvent) => void, options?: ClickOutsideOptions): void;
+
 export { }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cregis/ui",
   "private": false,
-  "version": "1.0.12",
+  "version": "1.0.14",
   "type": "module",
   "files": [
     "dist"